On Tuesday, 22 December 2015 at 14:57:22 UTC, Meta wrote:
If you don't know HTML then you probably shouldn't be doing
webdev.
Most the website is content articles, not web dev.
My ideal situation with the website would probably be a html
skeleton with ddoc in the contents, providing semantic content
macros in there.
....which isn't *too* far from where we are now! The html
skeleton is found in the DDOC macro here:
https://github.com/D-Programming-Language/dlang.org/blob/master/dlang.org.ddoc#L54
(why isn't that in html.ddoc? the multiple files is pretty wtfy
to me)
Though why ever it uses the ridiculous html pretending to be ddoc
macros is beyond me.
I have a lot of hatred toward the current state of the website
and documentation, but ddoc in principle really isn't one of
them. I don't feel it is enough (we could really use things like
auto generated tables of contents!) and I'm not married to it
(though the Phobos inline docs kinda are... let's not forget
about them), but it isn't that bad.
Just the way we're using it is pretty silly.
