Improving ddoc

Andrei Alexandrescu via Digitalmars-d digitalmars-d at puremagic.com
Thu Jan 1 01:43:13 PST 2015


On 1/1/15 1:34 AM, ketmar via Digitalmars-d wrote:
> i can fix something if i can read it, and i can't read that Ddoc mess.
> so i'm going to dlang.org to look at the dox instead of looking it
> right in the Phobos sources. and if i see something that can/should be
> fixed on dlang.org... ah, well, i have to drop the thing i was doing,
> open another terminal, go to Phobos source directory, find the file
> with the dox, then find the place to fix... screw it, i was looking at
> documentation for doing completely different things!
>
> but see, if Phobos documentation is human-readable without
> preprocessing, it's WAY EASIER for me to just open Phobos source file
> and look there. and guess what i'll do if i'll see that something needs
> fixing there? yep, i'll fix that, 'cause i'm already at the place that
> needs fixing. the process is not distractive. and then i can do 'git
> diff' and send a patch.

All you need is a mail client seeing as Walter offered you twice to 
email him any fixes you have and he'll integrate them for you. (Not to 
mention you refuse to use github etc.) Honestly if someone would pass 
similarly constructed arguments by you, would you put any weight on 
their opinion? I find your posts oddly awesome. Such cognitive 
dissonance is the stuff of legends. -- Andrei



More information about the Digitalmars-d mailing list