Beefy Boxes and Bandwidth Generously Provided by pair Networks
There's more than one way to do things
 
PerlMonks  

comment on

( [id://3333]=superdoc: print w/replies, xml ) Need Help??
I would like to propose a new section on Perl Monks. I am not a computer scientist by background and this is a factor behind me proposing this section. This section could be called 'Concise descriptions' or the fuller title of 'Concise English definitions for short pieces of Perl code'. The person submitting the request would submit a piece of Perl code that they are using and offer their own description of the code. Other people would then comment on the description and, in addition, offer their own description or definition. Eventually a set of nodes could achieve a highly concise, easy to understand description of a piece of Perl code. If such a section was popular, this would achieve several benefits. Firstly, it would enable terms that are only taught to computer scientists to gain currency with people of other backgrounds. It would aid those that answer routine questions (under seekers of Perl wisdom) to point to other nodes that contain these definitions, in order that the novice could better understand their suggested code. Thirdly, but not least, it would advance the English language as well as Perl. This benefit could lead to the publication of even better books that detail Perl.

I do think that Perl is a great language and very flexible. But with flexibility comes complexity and this is why I now think that a section like this on Perl Monks is worth considering.


In reply to A proposal: new section on Perl Monks. by Win

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post; it's "PerlMonks-approved HTML":



  • 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.
Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others contemplating the Monastery: (4)
As of 2024-04-19 15:58 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found