D: A language without focus
Kyle Furlong
kylefurlong at gmail.com
Thu Apr 27 00:31:12 PDT 2006
Walter Bright wrote:
> Probably the biggest problem you mentioned is the documentation.
> Fortunately, though, we now have Ddoc. I've been converting more of the
> older documentation files over to Ddoc format, and discovered what I
> expected: every one of the module documentation files either:
>
> 1) did not mention some of the functions
>
> 2) documented functions that did not exist
>
> 3) had documentation at odds with the code comments for the same function
>
> Ddoc, while not terribly sophisticated, is good enough to use, and it
> offers an enormous step forward in making it easy to write and keep up
> to date the documentation. It easily cuts the work in half, maybe more,
> and it certainly makes it easy to enforce a common look & feel to the
> documentation.
>
> Anyhow, I hear you. I welcome your help in any way you feel you can best
> contribute.
Really? If this is really true, and you welcome help, what shall we do?
How is one supposed to help you if you do not have a list of things we
can help you with?
More information about the Digitalmars-d
mailing list