|laziness, impatience, and hubris|
Re^3: Basic Literacy for P6 Advocatesby raiph (Hermit)
|on Aug 05, 2013 at 22:36 UTC||Need Help??|
a very sore point ... my boss tried to look at Perl 6 ... documentation ... assumed that he was already fluent in Perl 5
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.
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.