On Wed, Mar 28, 2012 at 06:58:45AM +0200, Alex Rønne Petersen wrote: > On 28-03-2012 06:13, James Miller wrote: [...] > >I think one more thing that needs some changing is the usability of > >the documentation, right now you get a dense list at the top, in > >mostly-alphabetical order (I think it puts caps first, then lower > >case) and then you get a massive list of classes and functions that > >are difficult to navigate. > > I think basically everyone dislikes this. [...]
The docs for classes and functions really need to be properly categorized according to utility, and not just presented in the order in the code or some arbitrary ordering (like alphabetical). Alphabetical is OK if you already know what you're looking for, but is horrible for newbies who have no idea where to even start. (And arguably even if you know what you want, alphabetical is only useful if you already know the exact name... otherwise you'd still want to look it up by category instead of name.) T -- "How are you doing?" "Doing what?"
