On 9/30/18 2:37 AM, Laurent Rosenfeld via perl6-users wrote:
There is no need for a question mark after the $limit parameter, since supplying a default value for a parameter is sufficient to make this parameter optional.


In this instance "yes", it is redundant.

But, other instances where a default value is not provided
and the variable is optional, "no".

And "yes" in all instances as it makes it more readable,
EVEN IF it has some redundancy in it. If one hint doesn't
get you, the other will.

Also, the "?" makes it clear that the variable is
optional.  Supplying it with a default value does not
always sink it that it is optional, unless you have had
to go through the pain of decrypting it once before

The goal is to make the documentation easy to use.  It
should not require a herculean effort to understand.
The manual need to be written for the common user to
understand, not just developer level and very advanced
users.  They don't need the manual anyway.

Reply via email to