I've always found it very useful and handy to be able to refer to print in a normal sentence, whithout having to think about linking too consciously. Just like how people sometimes use "()", like in int() to indicate something is a function, it is handy on Perl monks to do so with "[]", like in [int], and have it link to the documentatin. The power of usability in these links is the lack of schema. (And the high threshold in using Perl Monks's schema links is made even higher by the mandatory "//" after the colon.)

Even if just a stub page linking to the perldoc.perl.org, perldoc pages here would be a good idea. It's laudable that you don't want to break old links (though in that respect, changing titles of 2 year old nodes certainly doesn't help much), but I think there should also be a focus on the future. This focus should not just be pure, it should also dwim. (I'm referring to Perl versus other languages. I think it's dwimmy to say [perlop], and needlessly (unperlishly) verbose to say [doc://perlop].)

Perldocs are very well defined, and only very few are added. When one is added, the stub can be introduced by any user. I volunteer for updating perlcheat to point to the actual up-to-date document on perldoc.perl.org; In fact, I'll do so right away. :)

There are two things regarding perldocs on Perl Monks that "seemed like a good idea [at the time]", namely mirroring documents here, and having short intuitive dwimmy links. One of them still is.

As for updating old nodes, you're kidding, right?

Juerd # { site => 'juerd.nl', do_not_use => 'spamtrap', perl6_server => 'feather' }

In reply to Re^2: I want site documentation updates and I want them now. by Juerd
in thread I want site documentation updates and I want them now. by Juerd

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.