• John Gabriele (7/7) Dec 19 2017 I just went looking for the source for the dlang.org overview
• WebFreak001 (2/9) Dec 19 2017 ddoc, the D documentation thing https://dlang.org/spec/ddoc.html
• Meta (8/15) Dec 19 2017 https://dlang.org/spec/ddoc.html

John Gabriele <jgabriele fastmail.fm> writes:

I just went looking for the source for the dlang.org overview 
page, and found 
[this](https://github.com/dlang/dlang.org/blob/master/overview.dd).

I've seen and used a lot of markup formats, but have never run 
across this. What format is it? Also curious: for what reasons 
was it chosen over a more customary markup?

Thanks.

WebFreak001 <d.forum webfreak.org> writes:

On Tuesday, 19 December 2017 at 20:20:16 UTC, John Gabriele wrote:
 I just went looking for the source for the dlang.org overview 
 page, and found 
 [this](https://github.com/dlang/dlang.org/blob/master/overview.dd).

 I've seen and used a lot of markup formats, but have never run 
 across this. What format is it? Also curious: for what reasons 
 was it chosen over a more customary markup?

 Thanks.

ddoc, the D documentation thing https://dlang.org/spec/ddoc.html

Meta <jared771 gmail.com> writes:

On Tuesday, 19 December 2017 at 20:20:16 UTC, John Gabriele wrote:
 I just went looking for the source for the dlang.org overview 
 page, and found 
 [this](https://github.com/dlang/dlang.org/blob/master/overview.dd).

 I've seen and used a lot of markup formats, but have never run 
 across this. What format is it? Also curious: for what reasons 
 was it chosen over a more customary markup?

 Thanks.

https://dlang.org/spec/ddoc.html

When D was first created there was no clear documentation 
solution (as far as I know. I was not a programmer back then), so 
Walter invented DDOC. Actually it's a general text macro system 
and is not markup language or a documentation generation system, 
which may be why it seems so strange if you're used to stuff like 
javadoc/doxygen/etc.