Comment by Spivak
8 years ago
It's more important that there is convention than that the convention is optimal.
If the problem is that manuals aren't user friendly enough to new users and should have more examples of common tasks then they belong in the EXAMPLES section.
There's nothing that says you need to stick to the conventional sections either. A TUTORIAL section wouldn't be out of place.
No comments yet
Contribute on Hacker News ↗