On 9/15/13 9:53 PM, H. S. Teoh wrote:
On Mon, Sep 16, 2013 at 06:15:35AM +0200, deadalnix wrote:
On Sunday, 15 September 2013 at 18:38:54 UTC, Sönke Ludwig wrote:
Am 15.09.2013 19:20, schrieb Walter Bright:
On 9/15/2013 12:53 AM, Vladimir Panteleev wrote:
What happened with Ddox? This looks like an improvement in both
function and aesthetics:

http://vibed.org/temp/phobos/std/array.html

It doesn't document the parameters, return type, and doesn't
recognize embedded hyperlinks.

Just as a reminder, this is the current version:
http://vibed.org/temp/d-programming-language.org/phobos/std/array.html

I'm sold, that is awesome !

Me too.  Why aren't we working towards that, instead of trying to cook
up yet another hack on top of the current poor state of documentation?

https://github.com/D-Programming-Language/dlang.org/pull/271 consists mainly of a reorganization of the ddoc macros for PDF and ebook generation purposes, as well as helpers such as plaintext generator and "debugger". These are good starting points for anyone using ddoc for generating their own documentations.

I was at it so I thought I'd improve on the bag-of-words-at-the-top morass, too. It only took a little time. That was apparently unsuccessful so I'll remove it from the pull request.

https://github.com/D-Programming-Language/dlang.org/pull/267 is the pull request using ddox. That's a larger change of build tooling, which I plan to get to after 271 (with a revert to the bag-of-words) gets in.


Andrei

Reply via email to