Vague words are completely useless, yes, but sometimes just funny stories aren't good either.
Not uncommonly I find a link (in HN even) to a software product page and, arriving there, I'm greeted with pages and pages explaining what is all about and why I should use it. The pages are long, spread apart and in not-so-obvious places. Ah, there's also a 15 minute demo with a non-descriptive start. Fast forwarding shows some guy playing with a console terminal, but I can't even read what is he doing.
So, this is my two cents: not only you have to captivate your reader, but you must first show him where to start and convince him it's worth his time, either by already starting with something interesting or by making it short.
Comments
Vague words are completely useless, yes, but sometimes just funny stories aren't good either.
Not uncommonly I find a link (in HN even) to a software product page and, arriving there, I'm greeted with pages and pages explaining what is all about and why I should use it. The pages are long, spread apart and in not-so-obvious places. Ah, there's also a 15 minute demo with a non-descriptive start. Fast forwarding shows some guy playing with a console terminal, but I can't even read what is he doing.
So, this is my two cents: not only you have to captivate your reader, but you must first show him where to start and convince him it's worth his time, either by already starting with something interesting or by making it short.