I would say, put that famous book in the docs and see what happens. I would expect a positive outcome. Am I right chromatic ?
The core documentation has enough problems without another 70,000 words added to it.
I wrote the book and deliberately skipped some features, argued against using others, and ignored the entire default OO system in favor of Moose (before explaining the default object system as something you might have to maintain). It's one way to learn to write Perl 5 effectively. I hope it's useful for people, but it's certainly not the only way.
(Also I'd hate to have to debate stylistic choices on p5p before updating it for a new version.)
-
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.
|