Re: boo-boo in run docs?

[email protected] (Peter Pentchev) Fri, 7 Nov 2025 02:44:50 +0200

Newsgroups	perl.perl6.users
Message-ID	<[email protected]>

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 (application/pgp-signature, 833 B)