To quote something BrowserUk said a few months ago ... The point of this place ...

Don't take this the wrong way--I actually agree with you that the Perldocs could do with (links) to more examples--but there is a distinct and extremely important difference between this place and the Perldocs.

I'm not sure if it is a limitation of POD; the MAN format; or simply tuits; but the biggest limitation of the Perldocs is not content, but structure.

Given the hierarchal nature of HTML, it would be really nice to utilise that to have a keyword index; that linked keywords to summary descriptions; that linked to basic examples; that linked to expanded discussion; that linked to error messages and common pitfalls.

Probably the best producers of program and language documentation (that I've encountered), were the long defunct guys and gals at DEC. Besides that they appreciated the difference between understanding a subject and being able to convey it; their greatest skill was knowing that sometimes removing words is better than adding them.

Examine what is said, not who speaks -- Silence betokens consent -- Love the truth but pardon error.
"Science is about questioning the status quo. Questioning authority".
In the absence of evidence, opinion is indistinguishable from prejudice.
RIP PCW

In reply to Re^3: Where is if...elsif...else documented in perldoc? by BrowserUk
in thread Where is if...elsif...else documented in perldoc? by ELISHEVA

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.