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

Basic Literacy for P6 Advocates

by chromatic (Archbishop)
on Aug 04, 2013 at 20:26 UTC ( #1047825=note: print w/ replies, xml ) Need Help??


in reply to Re^4: A $dayjob Perl 6 program that runs 40x faster on the JVM than on Parrot
in thread A $dayjob Perl 6 program that runs 40x faster on the JVM than on Parrot

I chose to continue to contribute and try to attract more contributors in the face of ill-informed ridicule and attacks.

I stopped contributing because I was tired of people talking about how good things were surely going to be in the very near future and then doing almost nothing to make them happen. You're keeping up a fine and well established tradition here of making big promises based on things people say.

See Perl 6 documentation.

Keep telling yourself that a series of blogs, example mathematical puzzles, and Larry promising that this year for sure he'll write a book (he's been saying that since 2005) are acceptable forms of documentation that people like me want. (They aren't.)

I've always thought adoption will largely take care of itself and will reflect how robust the product is.

Finally, we agree on something.


Comment on Basic Literacy for P6 Advocates
Re: Basic Literacy for P6 Advocates
by raiph (Friar) on Aug 04, 2013 at 22:57 UTC
    Keep telling yourself that a series of blogs, example mathematical puzzles, and Larry promising that this year for sure he'll write a book (he's been saying that since 2005) are acceptable forms of documentation that people like me want. (They aren't.)

    You suggested that the only documentation was "a pile of specification tests hyperlinked to synopses under constant churn". That comment ignored the doc.perl6.org project and the above follow up does so again.

    You do Rosettacode a great disservice, and mislead monks, when you suggest that it's just mathematical puzzles. The 679 programming tasks cover any programming task contributors have chosen to contribute. It only takes a quick glance to see that most of them are things like basic and advanced programming techniques, file, string, Unicode, and date manipulation, and so on. (There are Perl 6 solutions for over 600 of them.)

    (Edit: removed comment about Larry, and simplified initial paragraph.)

      The so-called Perl6 documentation is a very sore point. Recently my boss tried to look at Perl 6, but all of the human-readable documentation he could find as an outsider assumed that he was already fluent in Perl 5. This is quite bad, as it prevents people who do not know Perl 5 from ever learning Perl 6, unless they take the detour through Perl 5.

      I don't know what to make of the linked http://doc.perl6.org/ - it feels to me like some automatically generated documentation that is not intended for human consumption. Maybe it is a good reference if you're looking for a concise description of how an operator works, but it surely can't be intended as the starting point for getting in touch with Perl 6.

        a very sore point ... my boss tried to look at Perl 6 ... documentation ... assumed that he was already fluent in Perl 5

        Ouch.

        P6 isn't ready for general consumption, and documentation is one of many reasons for that. That said, I don't think p6doc (doc.perl6.org) assumes knowledge of P5 (beyond its existence).

        http://doc.perl6.org/ - it feels to me like some automatically generated documentation that is not intended for human consumption. Maybe it is a good reference if you're looking for a concise description of how an operator works

        p6doc is intended to be the P6 equivalent of P5's perldoc. "I want p6doc and doc.perl6.org to become the No. 1 resource to consult when you want to know something about a Perl 6 type or routine (be it method, sub or operator)." -- Moritz, in the readme of the p6doc project.

        doc.perl6.org is ugly and less usable than it could be because no one has contributed a nice design. Given how simple and cleanly structured p6doc is, it should be relatively easy for a designer who knows CSS and JS to dress it up nicely. Know anyone?

        it surely can't be intended as the starting point for getting in touch with Perl 6.

        Right.

        Imo the smart starting point is to join the IRC channel #perl6 on freenode, introduce yourself, and ask for pointers. If you can't or won't join #perl6, see my P6-documentation-for-contributors PerlMonks post for some alternate starting points.

Log In?
Username:
Password:

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

How do I use this? | Other CB clients
Other Users?
Others avoiding work at the Monastery: (4)
As of 2014-07-24 04:33 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    My favorite superfluous repetitious redundant duplicative phrase is:









    Results (157 votes), past polls