Beefy Boxes and Bandwidth Generously Provided by pair Networks
more useful options

comment on

( #3333=superdoc: print w/replies, xml ) Need Help??
Run a perl style contest.

Pick a coding task, and have a panel of judges rank them on their documentation, code clarity, program structure, and overall performance of thier code (ie. does it do the task assigned, and no more? Does it do it correctly for all cases? Is it testable? Was it tested at all? Did the documentation include the test cases? Is the documentation easy to maintain (eg. literate programming techniques, where the documentation is embeded with the code)?

In short, run a contest on what you want to test: their ability to write "solid, readable code". Use the entries as a talking point for developing better coding style and practices within your department. A lot of the points of style are subjective; but that's entirely the point. You want your developers to understand what kind of code that you expect them to write: giving them examples of what you do and don't like will help much more than saying "just do it, and do it 'right'!"

Just my $0.02

In reply to Re: games played with Perl by Anonymous Monk
in thread games played with Perl by benrwebb

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, 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, 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.
  • Log In?

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

    How do I use this? | Other CB clients
    Other Users?
    Others romping around the Monastery: (4)
    As of 2020-02-22 07:27 GMT
    Find Nodes?
      Voting Booth?
      What numbers are you going to focus on primarily in 2020?

      Results (98 votes). Check out past polls.