Beefy Boxes and Bandwidth Generously Provided by pair Networks
laziness, impatience, and hubris

Re^13: A "Perl-7" that I could actually USE right now

by raiph (Chaplain)
on Dec 20, 2013 at 02:42 UTC ( #1067909=note: print w/replies, xml ) Need Help??

in reply to Re^12: A "Perl-7" that I could actually USE right now
in thread A "Perl-7" that I could actually USE right now

Some of the positive things I have to say about P6 doc are in my Perl 6 documentation post which I updated last month.

Larry Wall recently gained employment (with Craig's List) that frees him to focus on P6 spend (more) time on writing the P6 Camel. (In case it isn't clear, he's the one who said he'd write it, not me. I'm not promising. Just anticipatin'.)

To help him on his way, the P6 Camel draft, ie. the specs, got a lot of love in 2013:

  • lizmat (who, to post something out of context, is a well loved winner of one of this year's White Camel awards) decided to spend 8 months (so far) systematically reading, correcting and clarifying the entire series of spec documents -- while learning and hacking on the core to boot. Thank you lizmat!

  • FROGGS, lizmat, et al are most of the way through a nearly year long process of redoing/elaborating the design of, and fully implementing, S11: Units and Modules.

  • lue recently drafted the all new S15: Unicode. (NB. Unlike with the new S11, S17, and S21, implementation in Rakudo of S15 has barely begun.)

  • jnthn landed an entirely new (and almost entirely implemented on JVM) S17: Concurrency. It's a lot cleaner than its predecessor.

  • S21: Calling foreign code was basically replaced this year by the much cleaner documentation for Rakudo's already implemented foreign code calling facility Zavolaj.

  • etc.

I just remembered another significant doc improvement from 2013: the materials from the 2 day NQP workshop. With this we went from having very skimpy documentation of NQP, a key piece of the Rakudo compiler toolchain, to having sufficient documentation that folk who didn't attend the workshop can get up to speed on NQP.

I'm sure I'm missing some other stuff but I think I'm done with this current round of exchanges with you. Feel free to make some closing comments. :)

  • Comment on Re^13: A "Perl-7" that I could actually USE right now

Replies are listed 'Best First'.
Re^14: A "Perl-7" that I could actually USE right now (reaped for truth)
by Anonymous Monk on Dec 25, 2013 at 21:00 UTC
    Do you know the difference between "documentation" and "specs"? One of those is for real human beings who want to program. The other is for people engaged in selfish and pointless activities, activities that do not help other people, and who think it's -OFUN to write and rewrite and rewrite compilers.

    Compiler notes are not "documentation". Comments in source code are not "documentation". Math puzzles on RC aren't "documentation". Advent calendars aren't "documentation". Specs that aren't finished and are always being edited or promised to be edited aren't "documentation".

    How can I be more clear about this?

Re^14: A "Perl-7" that I could actually USE right now
by Anonymous Monk on Jan 18, 2016 at 03:01 UTC
    Two years later, and the docs are still as sad as this thread.

    The mascot should be an albatross, not that derpy bug.

Log In?

What's my password?
Create A New User
Node Status?
node history
Node Type: note [id://1067909]
[Your Mother]: The good news is, they think they are influencing people but Americans at least are irretrievably biased. All that can be accomplished is a little spike in domestic violence. :P
[LanX]: YM: watch your mouth or I'll show up with my automatic gun at your nursery ...
[LanX]: ;-P
[LanX]: What I learned now is to hide my friends list at FB (not that I have many ...)
[Your Mother]: Careful. They're listening!
[LanX]: I mean hiding my friends FROM my friends
[Your Mother]: Yeah. I don't know what they expect. If a stranger can see the post or list or whatever, so can a harvesting program.
[Your Mother]: HA.
[NodeReaper]: he's already hiding from me :(

How do I use this? | Other CB clients
Other Users?
Others scrutinizing the Monastery: (10)
As of 2018-03-19 13:29 GMT
Find Nodes?
    Voting Booth?
    When I think of a mole I think of:

    Results (240 votes). Check out past polls.