[Issue 18931] Additional sections for DDoc

[d-bugmail at puremagic.com]

https://issues.dlang.org/show_bug.cgi?id=18931

Jonathan M Davis <issues.dlang at jmdavisProg.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |issues.dlang at jmdavisProg.co
                   |                            |m
           Hardware|x86                         |All
                 OS|Mac OS X                    |All

--- Comment #1 from Jonathan M Davis <issues.dlang at jmdavisProg.com> ---
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.

--