Ready to make page-per-item ddocs the default?

Steven Schveighoffer via Digitalmars-d digitalmars-d at puremagic.com
Thu Jan 8 04:11:13 PST 2015


On 1/7/15 1:03 AM, Andrei Alexandrescu wrote:
> On 1/6/15 6:17 PM, Steven Schveighoffer wrote:
>> On 1/6/15 5:43 PM, Andrei Alexandrescu wrote:
>>> Let's crowdsource the review. Please check the entries linked from here:
>>> http://dlang.org/library/index.html.
>>
>> std.algorithm has many of the "descriptions" showing samples. Also, I
>> know the table at the top is to make things easier for standard ddoc,
>> should that be removed?
>
> But I like it.

It's redundant. Right below is the same exact info (see "Cheat sheet").

>
>> BTW, I'm all for the docs to be switched. Just the cross-referencing
>> alone is worth it.
>
> One thing we need to do is offer for each module "view as one page" so
> people still have that option.

That would be nice. In fact, I would recommend for when javascript is 
enabled, a way to "expand" a function/class inline.

-Steve


More information about the Digitalmars-d mailing list