On 7/10/2014 4:01 AM, Jacob Carlborg wrote:
On 09/07/14 23:46, Johannes Pfau wrote:
I think there's lots of valuable information on the wiki btw, which is
often overlooked for some reason. For contributors, wiki.dlang.org is
much nicer as you don't need ddoc, git, push rights/somebody to merge
pull requests, etc.
Is it only me that feels like ddoc doesn't scale for designing web sites.
Not just you, I've been kind of avoiding it. I like that it *exists* as
a built-in, and it's certainly better than those XML "comments" that C#
uses, but it still has poor readability (and writeability) *within* the
source, plus it's really just too "dumb": Purely zero-semantics
macro-like text substitution just isn't good enough. Realistically, you
just end up needing to post-process its results if you don't want to
feel like you've got your hands tied behind your back. In which case,
why even bother using it at all?
I've always wanted something in D that's more like Natural Docs:
http://www.naturaldocs.org/documenting.html
Macroed comments are just an overengineered mess compared to that.
