On Wednesday, 18 March 2015 at 03:45:07 UTC, Walter Bright wrote:
> 1. The sections Params, Returns, and See_Also need to be there. (Unless there are no parameters, or a void return.)

Any chance of getting a TemplateParams: (or Template_Params:) option in the next dmd release, too?  Would help very much with documenting ranges.

What in particular do you want in the See_Also? I'd have assumed it was only necessary for a subset of methods.

> 2. One PR per function being fixed.
>
> 3. Resist the urge to do more, stay focused simply on filling in the blanks, one PR per function, making things easy to review.

I'll see what I can do :-)

On 3/21/2015 1:00 AM, Joseph Rushton Wakeling wrote:
> On Wednesday, 18 March 2015 at 03:45:07 UTC, Walter Bright wrote:
>> 1. The sections Params, Returns, and See_Also need to be there. (Unless there
>> are no parameters, or a void return.)
>
> Any chance of getting a TemplateParams: (or Template_Params:) option in the next
> dmd release, too?  Would help very much with documenting ranges.

Just put them in Params:.

>> What in particular do you want in the See_Also? I'd have assumed it was only
> necessary for a subset of methods.

Functions that do something similar in case the function is not quite what they're looking for, along with other functions that are likely to be needed with it.


>> 3. Resist the urge to do more, stay focused simply on filling in the blanks,
>> one PR per function, making things easy to review.
> I'll see what I can do :-)

Thank you!

On Saturday, 21 March 2015 at 08:24:42 UTC, Walter Bright wrote:
>> Any chance of getting a TemplateParams: (or Template_Params:) option in the next
>> dmd release, too?  Would help very much with documenting ranges.
>
> Just put them in Params:.

Yeah, I'm not going to let it block contributing to this call for action.  But I would still like to have a separate TemplateParams for future (and personal project) use.

No promises, but if you can give me a pointer or two as to how that might be implemented, I'd consider having a look at doing it myself.

On 3/22/2015 7:21 AM, Joseph Rushton Wakeling wrote:
> No promises, but if you can give me a pointer or two as to how that might be
> implemented, I'd consider having a look at doing it myself.

It would be copy/paste of the code that implements Params:

But I don't see the added value for it, and probably would not pull it without a compelling rationale.

Thanks to everyone who has been filing pull requests on this!