DDoc could use some more sections. My ideas are:
* Citations
* Definitions
* Keywords
There should also be macros for AUTHOR, which could conditionally include a name, email, location, GPG keys, website, cryptocurrency wallets, etc.
Comment #1 by issues.dlang — 2018-06-02T03:34:12Z
You _can_ make up your own section names, you know. They just all end up using the DDOC macros DDOC_SECTION and DDOC_SECTION_H, whereas the standard ones get their own macros, so if you want to muck around with how they get formatted by redefining the macros for them, all of the non-standard ones get formatted the same.
And if there's something specific that you want to do with the author name, then you can always create your own macro for it. That's the sort of thing that really only matters when you want to affect how it's presented or add only pieces of the information and have the macro fill in the standard bits, and those are really going to be dependent on what you want to be displaying with every author name, and I don't think that you're going to get general agreement on what that should be. Phobos mostly just uses the authors name. At most, a few of use use a normal macro for generating a link and make our names be links to our websites, but not even that is very common. Author names aren't even consistently added. Ultimately, you have to look at the git history to see who did what. So, while I can see a helper macro for author names being useful, it sounds to me like the sort of thing that anyone who wants one is going to need to do themselves for their own project, since what it would entail really depends on their project.
Comment #2 by robert.schadek — 2024-12-13T18:59:00Z