dlang.org Library Reference

[H. S. Teoh]

On Fri, Dec 21, 2012 at 12:05:47PM -0500, Andrei Alexandrescu wrote:
> On 12/21/12 10:43 AM, Jacob Carlborg wrote:
> >On 2012-12-21 13:24, Sönke Ludwig wrote:
> >
> >>Example generated site is here:
> >>
> >>http://vibed.org/temp/d-programming-language.org/phobos/index.html
> >>
> >>
> >>Is any further work on this desired? If so, what would be the next
> >>steps to integrate it into the general dlang.org workflow? (or
> >>rather, how is that workflow in terms of folder structure, build
> >>scripts etc.?)
> >
> >Nice. Now we need to just remove those ugly manually create tables.
> >I'm thinking mainly on those on top of std.algorithm.

We need a way to group methods by (manually-assigned) category.


> s/remove/integrate/
> s/ugly/awesome/
> 
> The cheat sheet in std.algorithm is unnecessary (though I liked the
> brief examples), but there's a lot of value in the symbols grouped by
> category (searching, comparison, ...) at the top. So we need to have a
> means to group things in the new interface.

+1. The blob of links generated by JS at the top of the current pages is
(1) ugly, and (2) useless. Grouping symbols by category is by far more
useful. We need to keep that.


> >What also would be nice is to have the methods inline, expandable.
> 
> That would be awesome!
[...]

That would be nice, but could we make that optional please? As in, I'd
still like to be able to scroll down to read the perhaps longer and more
detailed description.

Alternatively, have the method signature and perhaps first paragraph or
two in the expandable header, which links to the full description
further down the page.


T

-- 
Try to keep an open mind, but not so open your brain falls out. -- theboz