On 04-08-17 17:24, Gerald wrote:
On Friday, 4 August 2017 at 15:08:27 UTC, Mike Wey wrote:
Improving the documentation is something i want to do but there are always some more important things to do. Like the Questions/Issues you posted earlier.

So unless somebody volunteers it won't happen anytime soon.

Mike I had contributed the makeddox.sh script awhile ago, it generates much nicer documentation then candydocs in my IHMO and includes a nice search box. If there is something lacking in it that needs to be improved before it can be used let me know and I'll do the work.

The only issue with it that I am aware of is you need to manually copy the public ddox css into the generated folder. I didn't see an easy way to determine it's location automatically.

One issue is the shear size of the generated documentation, though the current version of ddox no longer generates a ton of unused files bringing the size down from 15-20GB to a mere 2GB.

So it has at leased become manageable to host it on the VPS that hosts gtkd.org.

Now remains figuring out setting up the proper redirects on the server, and a few personal preferences about ddox:

The need to go trough the empty module page when browsing the documentation. For a lot / most? functions the complete documentation is in the overview defeating the purpose of the one page per artifact.
And im not a big fan of the one page per artifact style of documentation.

Mike Wey

Reply via email to