ddox problems

[John-Colvin]

E.g. https://dlangscience.github.io/dstats/api/dstats/summary/geometricMean.html is 404 and is linked from https://dlangscience.github.io/dstats/api/dstats/summary.html

[John-Colvin]

https://github.com/rejectedsoftware/ddox/issues/91

[9il]

I like https://github.com/kiith-sa/harbored-mod

[ghost]

I don't know enough about ddox vs. harbored-mod to give feedback, but I think this should be discussed/decided right away, no?

[9il]

No, we can migrate later.

[John-Colvin]

Yes, we should stick with ddox for now. Swapping from harbored-mod back to ddox would be hard if we e.g. used ant of its markdown syntax, but ddox -> harbored-mod should be easy if we find we need to at a later date.

[ghost]

Okay. I was exactly thinking of markdown within ddoc as a unified solution for general site and api docs, but maybe it's too soon to head down that road.

[ghost]

Concerning rejectedsoftware/ddox#91, does this post show a general way to specify ddox options when using dub build?

[John-Colvin]

@jansengb only for the filter stage. dub is rubbish for configuring ddox, I've rolled our own solution (see e.g. https://github.com/DlangScience/clFFT-D/pull/4)