On 2020-06-07 22:39, Peter Pentchev wrote:
I thought I explained that. The Rakudo developers are*never* finished
with the development of some methods. Somebody*will* want to extend
them in their own module. The Rakudo developers*want* to declare some
methods as "multi" to allow the Rakudo users to write Raku programs that
extend some existing classes to make them do interesting things.
You did and I understood it. Your explanation was well
though out/
What you missed was my point that the developers have a
process for checking in new code. Part of that process
is updating the documentation. That is the proper
time for documentation to be updated. The purpose of
the documentation is not to keep places open for unicorns.
Now you are absolutely correct that the software is NEVER finished. But
Raku is not a "daily" release to the public.
They exist, but are not released to the general public.
Raku has releases. When the new release his, the
documentation need to match the release. It is
all part of the check in process.
What did you learn from going to Github? That you may call
.starts-with() without the :i or :m parameters? Was that not written in
the documentation? Or that you may call .starts-with() with a $needle
being Cool and not Str? Again, was that not written in the
documentation? So what did you learn from going to Github that was not
in the documentation?
Nothing I remember. But that was not my point.
I addressed this in my original e-mail: the documentation is currently:
1. a reference manual
Targets at what audience?
2. some tutorials with more being written.
Always appreciated.
Yes, the documentation needs more work. Yes, it is being worked on.
But for what target audience?
The Perl 5 documentation has been worked on for literally 20 more years
than the Raku one.
Good point. Although I do not see the target audience
being altered for both the beginner and the advanced
user. Just the advanced user that already know how to
use it and don't need it, except for a refresher.
Reminds me of that saying bad teachers in college use to
use: "It is intuitively obvious and let up to the student
figure out."
I love your writing by the way.
-T
