Some feedback on the website.

Jacob Carlborg via Digitalmars-d digitalmars-d at puremagic.com
Wed Dec 16 23:59:04 PST 2015


On 2015-12-16 21:59, Andrei Alexandrescu wrote:

> If some of these are unnecessary, they can be easily fixed. There's no
> problem with breaking other people's code etc.
>
> Which would you eliminate?

A sane doc generation system would need at most two 
macros/syntaxes/functions to create links. One macro accepting a symbol 
name (fully qualified or not) used for cross-referencing and one macro 
used for page and external links, accepting a relative or an absolute URL.

It's also possible to manged without any of these at all. The doc tool 
could automatically do cross-referencing and detect URL's.

-- 
/Jacob Carlborg


More information about the Digitalmars-d mailing list