D Language Specification

[Dibyendu Majumdar]

On Tuesday, 14 May 2019 at 07:47:36 UTC, Bastiaan Veelo wrote:
>> Apologies if this question has been asked before. Is there a 
>> reason why the spec cannot be written in something like 
>> RestructuredText or Markdown? I ask because github natively 
>> supports these formats, which makes it easier / more 
>> productive.
>>
> All of dlang.org (as far as I can see) is written in ddoc, the 
> D embedded documentation format 
> https://dlang.org/spec/ddoc.html. It produces output in various 
> formats, not just HTML. If you don’t want to set up your local 
> build of the website, then you can still make the pull requests 
> and inspect the results as built by the testing bots that will 
> be accessible from the PR page. While you are iterating, you 
> may want to prepend your PR title with “[WIP]”.
>

Thank you for the tips.

I am happy to work with ddoc but it seems unnecessary friction.

Regards