On Thu, Nov 06, 2025 at 05:57:06PM -0600, Tom Browder wrote: > On Thu, Nov 6, 2025 at 17:34 ToddAndMargo via perl6-users <perl6 > [email protected]> wrote: > … > > I wish Raku would take a page from Perl5's documentation, > > which is very easy for a beginner to pick up. They > > start with simple examples, explain everything thing involved, > > then work up to the fancy stuff. (Raku is a great clean > > up of Perl 5, except for the documentation.) > > Todd, I wholeheartedly agree with you. I do not cast aspersion on the Raku > doc writers, but I wish we could agree on some practical middle ground. > Remember, Perl infra has been around many more decades than Raku, and has > had many more people tackling the problem.
For the record, despite the tone that seems to have escaped in some of my messages, for which I apologize to Todd, I can also clearly see the difference between Perl 5's long, explanatory documentation with lots of detailed intro-level documents, and Raku's reference-style one. I do understand that concise reference-style documentation can be not entirely helpful for people who do not know a lot about the subject matter. What I object to is mainly assertions that the reference-style documentation is incomplete. It is complete, it is just not easy to grasp for people who have little experience with the concepts they're reading about. G'luck, Peter -- Peter Pentchev [email protected] [email protected] [email protected] PGP key: https://www.ringlet.net/roam/roam.key.asc Key fingerprint 2EE7 A7A5 17FC 124C F115 C354 651E EFB0 2527 DF13
signature.asc
Description: PGP signature
