On Wednesday, 3 April 2024 at 16:25:49 UTC, Mike Parker wrote:
The D Language Foundation's quarterly meeting for January, 2024
took place on Friday the 5th at 15:00 UTC. It lasted for about
45 minutes.
[snip]
Thanks for the write-up, as always.
__Question about Ddoc__
Second, when documenting template parameters vs. regular
paramters, was there a separate segment for template
parameters? In the language and the code, they were distinct,
but in Ddoc there was only `Params:`. Mathias said that putting
them all in `Params:` handled it.
Vijay asked if grouping them together was the right choice
given that they were distinct in the language and the code.
Mathias thought so. He said that at Sociomantic (where they had
maintained their own fork of the compiler), they'd implemented
`Template_Params:` at one point. He said from his experience
with that, there wasn't much value in it. If we really wanted
to separate them, the compiler could figure it out and we could
just display them separately. But he didn't see the value in it.
Átila agreed. He said that you knew the names, the names
weren't going to repeat, so you could probably tell them apart.
I haven't found myself needing a separate section for template
parameters, but I've come across a number of bugs associated with
ddoc (or ddox, I can't recall the difference) [1] and some are
related to how it handles more complicated templates.
[1]
https://issues.dlang.org/buglist.cgi?email2=john.michael.hall%40gmail.com&emailassigned_to2=1&emailcc2=1&emaillongdesc2=1&emailreporter2=1&emailtype2=substring&query_format=advanced&resolution=---&short_desc=ddoc&short_desc_type=allwordssubstr
