The ugly truth about ddoc

[Andrei Alexandrescu via Digitalmars-d]

On 1/18/15 7:28 PM, Mike wrote:
> On Monday, 19 January 2015 at 03:02:37 UTC, Andrei Alexandrescu wrote:
>
>>>> Destroy!!! What's not working? -- Andrei
>>>
>>> For starters, simple, accurate instructions in dlang.org's Readme.md
>>> file.
>>>
>>> Mike
>>
>> "There's a bug report for that."
>> https://issues.dlang.org/show_bug.cgi?id=14006
>
> That's a separate issue.  I'm referring to problems like this:
> https://issues.dlang.org/show_bug.cgi?id=13436
>
> The instructions are absent in readme.md and wrong or broken in
> contributing.md.
>
> So, you might be wondering, why don't I fix it.  Answer, because I don't
> know what it should be.  This should be fixed by someone who already
> knows the build process, so others who don't know have a something
> working to start with, and can eventually inherit the maintenance and
> knowledge so they, themselves, can pass it on to others.

Agreed. If there's anything to add, add to 13436. -- Andrei