Readme.adoc jumps straight into Installation with no intro on what the tool does or why you'd want it. Front-load: one-line description, a demo (the old Ruby repo's cinemas/listings.cinema.gif works fine, same UX), then the concurrency win as the concrete why - installation/usage details after, not before.
Readme.adoc jumps straight into Installation with no intro on what the tool does or why you'd want it. Front-load: one-line description, a demo (the old Ruby repo's cinemas/listings.cinema.gif works fine, same UX), then the concurrency win as the concrete why - installation/usage details after, not before.