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?

In reply to Re^14: A "Perl-7" that I could actually USE right now (reaped for truth) by Anonymous Monk
in thread A "Perl-7" that I could actually USE right now by locked_user sundialsvc4

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.