std.containers - WAT

[H. S. Teoh]

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?"