On Friday, 16 August 2013 at 19:12:46 UTC, Mr. Anonymous wrote:
On Friday, 16 August 2013 at 18:12:57 UTC, Andre Artus wrote:
Is there a way to break the pages into a more of a hierarchy,
so that documentation for each module doesn't have to be on
one page? Perhaps a DDOC Section could indicate the category?
Are you familiar with DDOX?
http://vibed.org/temp/d-programming-language.org/phobos/index.html
I have not yet had the time to look into it, but I fear that it
would be of little use if it's not the official way of doing
docs. Although it may be the preferred option for private
projects or projects not directly connected to the main D
ecosystem. There is already quite a lot of fragmentation making
it quite an effort to find out what the "one true path"[1] is.
1. I realize that there isn't truly such a thing, but an
opinionated starting point is of great help to noobs. The major
feature to popularize Ruby on Rails when it first kicked off was,
in my opinion, the "on rails" part. You had a very clear
indication of where to start, and what the best/accepted/expected
practices are. Once you have accustomed yourself to the language
and framework you can find ways to go crashing through the bushes
if you feel the need to do so.
