I know that writing style is standardized in magazines. I'm not sure about
coding style, though I'm sure it's standardized in books. There's not the
same style in every book, but within a given book, the coding style would
probably be consistent. Doing the same on PerlMonks would be in keeping
with the standard for code conformity set by the non-electronic media.
There isn't much of a standard on the web. I don't know of another message
board with a significant number of full length scripts. But more important
than that is setting a good example with the posted code.
There are a lot of people on this site contributing a lot of content for a
lot of different reasons. Some of the code in the snippets and code
sections may be there for pedagogical purposes, but most is probably posted
with only the intent of sharing the code. Trying to enforce a particular
style on those sections would be like trying to enforce a coding style on
CPAN submissions. Shall we also set up a GrammarTidy for non-code content?
-
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.
|
