|
>> Middleman is a static site generator using all the shortcuts and tools in modern web development. Getting started. Most of the websites, including Middleman's home, for some reason jump too fast from defining what the project is to "getting started". There needs to be a link to more information about what the project is, tailored to people who are unfamiliar with the space, followed by more information defining what distinguishes the project/product from others in the same space. Once the reader understands what the project is and how it fits what she is trying to do, and why it is more suited to them than others, then comes the Getting Started aspect. If the reader needs to go though the "Getting Started" section and try the product out to figure how it would help them, then the product pitch has not been done right or at all. In this blog, we see a mention of Jekyll, followed by no words about why someone should not just use Jekyll which is also stated to be the at the core of this movement. While the answers may be obvious to some people, they are not obvious, and should always be explicitly stated. The "hello, world" paradigm itself is often misused in my opinion. In a large number of cases, "hello, world" is not a demo program but rather a test to make sure installation went right. I would first like to see a demo of the key aspects of the product, explained on the website, before getting to the hello world. Ah, it's Friday today. No seriously, the intention of my rant is to either have someone explain to me why product websites are so often like this or try to influence them to change. |