D Language Specification

[Seb]

On Tuesday, 14 May 2019 at 08:41:53 UTC, Dibyendu Majumdar wrote:
> 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

I have some good news: starting with the 2.086 release, Ddoc 
supports markdown via the experimental -preview=markdown flag and 
the plan is to enable it soon for dlang.org.