News for hackers. Stuff that matters.
Re:Daux.io, a simple documentation generator by fernly on Monday July 15, 2013 @12:22AM (#6043699)
I suppose "daux" is meant to be pronounced "docks" but a French-speaker would say "doh!" like Homer Simpson.

Trivia aside, the front page does nothing to make the purpose or advantages clear. What is "custom documentation"? (Is there another kind?) What is the advantage of "on the fly"? (As opposed to the typical "make doc".)

Is there some way to create a multi-level hierarchy within the "01_Getting_Started.md" filename convention? Is the filename structure the _only_ way to indicate structure? (If so, a trivial structure change turns into a nontrivial exercise of renaming files and getting git or svn to accept renamed files as logically unchanged.) Is there a way to cross-reference (link) between files? Is there a way to output in PDF, or any other format?

There are no comments on this comment yet.