With your comment on man pages, I've been thinking a lot about lately; the fact is, we completely neglect documentation, so much that its neglect resulted in it being pushed up a layer, into the browser - namely, google (and stackoverflow).
Fundamentally, we don't really do discoverability well because volunteers are fickle as hell, and commercial interests are profit-focused.
Fundamentally, we don't really do discoverability well because volunteers are fickle as hell, and commercial interests are profit-focused.