With respect to updated documentation: although I love being able to easily link to the documents, it also strikes me as innecessary that vroom has to keep updating them, when there is something like PerlDoc whose only purpose in life is to keep up-to-date documents of all things Perl. So I got to thinking: maybe an arrangement between PerlMonks and PerlDoc could be made, so that perlman: (and possibly perlfaq:) links take you to the corresponding page in PerlDoc? I don't how how easy it would be to integrate this into the Everything engine, particularly so that it keeps being transparent to the user (this is, not have to explicitly type "perlman:", but just create a link to the name of the function and have it do the right thing).

With respect to keeping different versions of the documentation, I think it would be a fantastic idea. I tried to find older documents at PerlDoc, but I couldn't find them. Maybe it would also be a good thing to suggest to them?

--ZZamboni

In reply to Re: the state of perlmonks' perldocs by ZZamboni
in thread the state of perlmonks' perldocs by Vynce

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.