Generating API documention

[Seb]

On Thursday, 10 January 2019 at 07:04:52 UTC, George wrote:
> What do people use to generate nice looking and simple html 
> documentation for their projects? I would be glad (and if 
> possible), someone could share some actual instructions rather 
> than just tell me ddoc. For example I have seen the libmir 
> (http://docs.mir.dlang.io/latest/index.html) and I would love 
> to generate something similar for a project I am working on.
>
> Thank you and best wishes.
> George

This was actually done with Ddoc (author of the ddoc setup for 
Mir here) ;-)
See: https://github.com/libmir/mir/tree/master/doc


It uses the dlang.org Ddoc theme and customizes it a bit, but is 
fairly tricky to setup and maintain.
Also, it doesn't work with dub.

For a nice out of the box experience, I would recommend scod

https://github.com/MartinNowak/scod

Example project: https://github.com/MartinNowak/bloom


Also note that with dpldocs.info you'll automatically get 
documentation for your project once its published on the Dub 
registry, see e.g. https://pbackus.github.io/sumtype/sumtype.html