On Thu, 04 Mar 2010 03:55:40 -0500, Jonathan M Davis
<[email protected]> wrote:
On a side note, it would be great if we could figure out a way to make
the
docs more user-friendly - especially in std.algorithm. The functions are
great, and they're really versatile, but that seems to come at the cost
of
incredibly nasty signatures. It can make it hard to find the function
itself
among all of its parameters and its return type (especially the return
type). Right now, I'd expect it to scare a fair number of potential users
away. What the best solution would be, I don't know (perhaps making it so
that it lists information on the function without its signature and then
lists the signature at the end, or maybe we could find some way to give
an
abstracted signature which gave the basic idea without all of the
details),
but right now std.algorthm is definitely scary-looking. It's got great
stuff, but the docs could definitely use some improvement.
It is an issue with DDoc. I think the signatures are not that nasty if
you look at the actual code. I think DDoc expands all aliases so you get
the full template-expanded signature.
-Steve
