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:

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.