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?).
Having automatically updated docs hosted on code.dlang.org will
motivate package developers to write better ddoc comments for
their code.
It will get library packages more usable, and attract more users.
