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