dub projects generate docs and host on code.dlang.org?

Vadim Lopatin via Digitalmars-d digitalmars-d at puremagic.com
Wed Sep 6 07:04:56 PDT 2017


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.




More information about the Digitalmars-d mailing list