Improving ddoc

via Digitalmars-d digitalmars-d at puremagic.com
Thu Jan 1 08:15:08 PST 2015


On Thursday, 1 January 2015 at 12:05:03 UTC, Walter Bright wrote:
> There is also nothing stopping anyone from using Doxygen if 
> they prefer it.

Sure, but there is a big advantage in having a the same tech doc 
format for all libraries for the same language/group of languages.

I've spent way too much time learning new essential languages, so 
learning a new one for a fringe activity like writing tech docs 
is not going to happen.

Picking a common subset of an existing markup language will 
reduce resistance to learning the one D is using. Doxygen syntax 
is a good candidate if you want people to write uniform docs for 
D libraries. Especially if D is going to continue to focus on C++ 
integration.



More information about the Digitalmars-d mailing list