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

Andrei Alexandrescu via Digitalmars-d digitalmars-d at puremagic.com
Wed Jan 7 14:35:39 PST 2015


On 1/7/15 11:12 AM, Jacob Carlborg wrote:
>
> Most of the ideas I had might require some redesign of the documentation
> layout, these are:
>
> * Summary of symbols
> * Documentation for private symbols
> * Simplified signatures
> * Links to all base classes and interfaces of a class
> * Links to all symbols from all base classes and interfaces
> * Links to all known subclasses
>
> BTW the thing that have bothered me the most when writing documentation
> is there's no good way to even manually cross-reference symbols. We
> really should have a special syntax for that as well.

The way I see this, these items are good to have and by nature of our 
process will be deployed (if at all) incrementally by whomever is 
interested in implementing them. We can't afford to block progress of 
docs layout on this possibility. -- Andrei



More information about the Digitalmars-d mailing list