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
-
Are you posting in the right place? Check out Where do I post X? to know for sure.
-
Posts may use any of the Perl Monks Approved HTML tags. Currently these include the following:
<code> <a> <b> <big>
<blockquote> <br /> <dd>
<dl> <dt> <em> <font>
<h1> <h2> <h3> <h4>
<h5> <h6> <hr /> <i>
<li> <nbsp> <ol> <p>
<small> <strike> <strong>
<sub> <sup> <table>
<td> <th> <tr> <tt>
<u> <ul>
-
Snippets of code should be wrapped in
<code> tags not
<pre> tags. In fact, <pre>
tags should generally be avoided. If they must
be used, extreme care should be
taken to ensure that their contents do not
have long lines (<70 chars), in order to prevent
horizontal scrolling (and possible janitor
intervention).
-
Want more info? How to link
or How to display code and escape characters
are good places to start.
|