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

Seb via Digitalmars-d digitalmars-d at puremagic.com
Tue Sep 5 09:13:40 PDT 2017


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


More information about the Digitalmars-d mailing list