Beefy Boxes and Bandwidth Generously Provided by pair Networks
P is for Practical
 
PerlMonks  

Re: To monks who are interested in contributing to Perl 6 but are not now doing so. What is stopping you?

by fisher (Priest)
on May 14, 2013 at 15:59 UTC ( #1033515=note: print w/ replies, xml ) Need Help??


in reply to To monks who are interested in contributing to Perl 6 but are not now doing so. What is stopping you?

Hey but...

Just before contributing I believe I should became a user for this product. But the last time I tried Rakudo I found myself in struggle just because of lack of documentation.

When I say 'documentation' I actually mean the full chain of 'quick getting started', 'the complete user manual', and 'internal architecture/design for hackers'. All I saw before was the type one of these, how to install and run the fresh-built binary. Yes I understand that the code itself is not yet done, but this fact is not a blocker for documentation process. I believe this needs a huge effort from developer team and especially project leads -- take as an example the OpenBSD project -- they refuse any changes if these changes are not documented.

Resuming -- no how-tos, but the complete manual is needed to gain userbase and only after that the part of it maybe became your contributors. This is just my opinion, hope it helps.


Comment on Re: To monks who are interested in contributing to Perl 6 but are not now doing so. What is stopping you?
Perl 6 documentation (Re^2: To monks who are interested in contributing to Perl 6 but are not now doing so. What is stopping you?)
by raiph (Hermit) on May 16, 2013 at 20:52 UTC
    Updated Nov 2013. Reformatted, tweaked content, mentioned videos and jnthn's slides.

    Added Dec 2013. re: 'internal architecture/design for hackers'.

    If you last looked more than 18 months ago, I'd say the doc situation has significantly improved. There isn't a complete manual by any means, but perhaps what is now in place is enough to get some folk up to speed.

    New since summer 2012 or thereabouts:

    Of course, some doc related projects started more than a year ago have been further developed. Most notably, Larry Wall, with help from a few others, has pushed the count of Perl 6 Rosettacode entries to around 600.

    (Talking of Larry, he has said he is working toward publishing an O'Reilly book, a Perl 6 equivalent of the Perl 5 "bible" Programming Perl.)

    With all that said, a word of caution. If by "user" you mean relying on Perl 6 the way someone might rely on Perl 5, things are far, far from that. Perl 6 won't be able to support users and doesn't need contributors in the way that Perl 5 supports users and needs contributors; Perl 6 can only support users willing to work with it despite its many weaknesses and relatively high rate of change from release to release.

    Hth someone!

      "a solid start of what may become" ?

      What is so defective in perl-6 that you believe that is acceptible? Is that supposed to make people happier about perl-6? Why not tell people "oh the source code documents itself" and admit that you hate the users you don't have? What is so hard to admit about that?

Log In?
Username:
Password:

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://1033515]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? | Other CB clients
Other Users?
Others chilling in the Monastery: (6)
As of 2014-09-20 18:05 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    How do you remember the number of days in each month?











    Results (160 votes), past polls