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