D Language Foundation January 2024 Quarterly Meeting Summary

[jmh530]

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