<html>
<head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
Ok, Ddoc is great at writing D documentation, that's what it was
designed for. Why use a tool designed for code documentation as a
web templating language? Aren't we (as programmers) always saying
use the right tool for the right job...<br>
<br>
I understand Ddoc's <a
href="http://www.digitalmars.com/d/2.0/ddoc.html">advantages</a>
now. No-one is saying Ddoc is hard to learn (at least I'm not saying
that) but with so many tools, languages and frameworks to learn
these days should it be necessary to know it when you're a D
enthusiast that wants to contribute a HTML tutorial on
d-programming-language.org.<br>
<br>
My 2-cents,<br>
<br>
Chris<br>
<br>
<br>
On 06/29/11 12:25, Walter Bright wrote:
<blockquote cite="mid:iuf2cs$1jfr$1@digitalmars.com" type="cite">On
6/29/2011 1:38 AM, James Fisher wrote:
<br>
<blockquote type="cite">However, the case for using
<br>
it for the website
<br>
<a class="moz-txt-link-rfc2396E" href="https://github.com/D-Programming-Language/d-programming-language.org/blob/master/index.dd"><https://github.com/D-Programming-Language/d-programming-language.org/blob/master/index.dd></a>
<br>
is nonexistent (anyone disagree?).
<br>
</blockquote>
<br>
I do. Ddoc is:
<br>
<br>
1. Rather trivial to learn & use. A website/book/community
devoted to how to use it is completely unnecessary. It's fairly
obvious how to use it (for someone with a basic familiarity with
HTML) by simply looking at a couple examples.
<br>
<br>
2. It automatically tracks the D language, so D code examples are
always properly highlighted.
<br>
<br>
3. It is always available and installed for anyone who installs D.
<br>
<br>
4. The D compiler and Ddoc are always in sync. No begging for
updates from 3rd parties, no lags even if they get right on
incorporating necessary updates.
<br>
<br>
5. It is not necessary to direct anyone to install some third
party system that may not even exist on all the platforms D does.
In general, we try to minimize dependency on things that are not
default installed across operating systems.
<br>
<br>
6. And lastly, it works, it delivers, and has for many years. It's
proven its worth.
<br>
<br>
<br>
If a professional web designer uses famous system X to develop
with, and if we used famous system Y, it's just as much a barrier
for him to relearn how to do things with Y as it is to learn Ddoc.
<br>
<br>
Please don't be too dismissive of the productivity gains from
using Ddoc. At the time we started using it, the website and the
Phobos documentation improved by huge leaps and bounds, simply
because it was so easy to generate decent documentation with Ddoc.
<br>
</blockquote>
</body>
</html>