On 9/26/18 7:08 PM, Brandon Allbery wrote:
English is not a programming language, so it will not help you with
understanding what Positional is. Or Callable. Or Mix, or any of the
other types and roles in Perl 6. Perl 5 has none of these, so it is
never a problem in Perl 5. Instead you have to memorize a bunch of weird
special case rules for the things Perl 5 does know about -- and perldoc
expects you to have done so. You don't notice because you've already
memorized them.
Not an excuse for poor explanations. Perdocs leaves you knowing
how to "use" the functions. Perl 6's does not, unless you
already know how to use it, then your don't need it.
So rather than grumbling about it, I am going to start
trying to be part of the solution, rather than just
grumble about the problem.
This is my latest:
A booboo and an rfe in contains documentation
https://github.com/perl6/doc/issues/2334
Thank you for all the help with this.
-T