After looking at open source api docs last night, do you know what would be really helpful, especially with the Linux focused ones (because most of those assume dependency on search)?

If the people writing the API docs would stop using common words for modules, calls, etc. Even better is if the docs for the API entry are exact matches for what is written in the code.

A module called "stasis" is a terrible name. Worse is naming something m.stasis but documenting it in the API docs as Stasis. Searching for "Stasis" or other common dictionary words is a bad idea. Not much better than naming calls and modules: a, the, and, so, huh, and that.

Maybe I should write a worst practices example app for April 1.