Better ddoc defaults?

via Digitalmars-d digitalmars-d at puremagic.com
Thu Mar 9 23:58:36 PST 2017


On Thursday, 9 March 2017 at 21:08:17 UTC, Yuxuan Shui wrote:
> I'm using ddoc for the first time. I was naively expecting 
> something resembles dlang.org, and the results is a bit 
> disappointing. So I looked at dlang.org and realized lots and 
> lots of ddoc templates are required to achieve that.
>
> As the developer of a tiny package that nobody cares, I want to 
> have a nice looking documents page, but I don't want put too 
> much (or any!) time into it. And I don't care whether my 
> documents have any "personality". I guess a lot people would 
> agree.
>
> So why don't we make the defaults more beautiful? Or make the 
> dlang.org templates easier to adopt for average users?

My favorite one is: https://github.com/MartinNowak/scod.

BTW, the default ddox (the one that comes with dub) is getting an 
upgrade soon: https://github.com/rejectedsoftware/ddox/pull/149
https://github.com/rejectedsoftware/ddox/pull/150.


More information about the Digitalmars-d mailing list