On Tuesday, 5 September 2017 at 02:21:26 UTC, Nicholas Wilson
wrote:
On Monday, 4 September 2017 at 10:47:47 UTC, Manu wrote:
I've seen a lot of dub projects with embedded ddoc that
follows phobos
example.
These projects are then hosted on code.dlang.org, but often,
the docs are
never generated and hosted anywhere.
In the event they are, links to docs are ad-hoc and
unpredictable, and the
formatting/styling/etc is not standard/consistent.
Suggest; code.dlang.org should attempt to generate ddoc for
each hosted project, host it, and clearly link to it from the
project front-page. Hosted docs should be styled consistently
(matching phobos?).
Thoughts?
- Manu
Mir uses http://docs.algorithm.dlang.io/latest/index.html for
its docs. Perhaps something like it could be extended for other
projects?
I think Sebastian Wilzbach would be the person to contact about
this.
Unfortunately the setup for Mir's repositories is quite
complicated as it's based on Ddoc and dlang.org.
I think a better approach would be to use adrdox or Ddox with the
scod theme [1].
[1] https://github.com/MartinNowak/scod
