dlang-community / libdparse

Library for lexing and parsing D source code
https://libdparse.dlang.io
Boost Software License 1.0
114 stars 56 forks source link

Which documentation generator to use? #469

Open WebFreak001 opened 1 year ago

WebFreak001 commented 1 year ago

In the README for a while we had https://libdparse.dlang.io linked to but on the DUB package page there is the auto-generated documentation using dpldocs (adrdox): https://libdparse.dpldocs.info/v0.20.0/index.html

I'm personally a fan of adrdox because it shows a lot more things that are interesting for users as well as custom parsing code that adds things which aren't emitted in the ddoc output. Maybe we should switch to it for the documentation generation? Then we can also configure it on the dub package and could add extra custom documentation pages as well as customize the styling.

Opinions? @Geod24 @Hackerpilot