Phobos Documentation - call to action

Walter Bright via Digitalmars-d digitalmars-d at puremagic.com
Sat Mar 21 01:24:00 PDT 2015


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!


More information about the Digitalmars-d mailing list