Beefy Boxes and Bandwidth Generously Provided by pair Networks
laziness, impatience, and hubris
 
PerlMonks  

Re: 20 most important Perl Best Practices

by eyepopslikeamosquito (Archbishop)
on Aug 22, 2012 at 22:12 UTC ( [id://989158]=note: print w/replies, xml ) Need Help??


in reply to 20 most important Perl Best Practices

I have some experience in this area, starting from the time I wrote On Coding Standards and Code Reviews.

I think a top twenty list is a good idea because many folks are turned off by very long lists. However, the top twenty list should focus on things that matter -- not trivia or dogma.

Unfortunately, your list seems to focus on things I would describe as "trivia". Indeed, most of your list could be covered by a single point: "Agree upon a coherent layout style and automate it".

Here's my attempt at a top twenty list:

  1. Correctness, simplicity and clarity come first.
  2. Avoid unnecessary cleverness. If you must rely on cleverness, encapsulate and comment it.
  3. Avoid duplication (DRY).
  4. Coupling and Cohesion. Systems should be designed as a set of cohesive modules as loosely coupled as is reasonably feasible.
  5. Data hiding. Minimize the exposure of implementation details.
  6. Minimize the scope of variables, pragmas, etc..
  7. Establish a rational error handling policy and follow it strictly.
  8. Interfaces matter. Once an interface becomes widely used, changing it becomes practically impossible (just about anything else can be fixed in a later release). Design the module's interface first.
  9. Design interfaces that are: consistent; easy to use correctly; hard to use incorrectly; easy to read, maintain and extend; clearly documented; appropriate to your audience. Be sufficient, not complete; it is easier to add a new feature than to remove a mis-feature.
  10. Write components that are testable in isolation.
  11. The result of every file operation or API call or external command should be checked, and unexpected results handled.
  12. Use descriptive, explanatory, consistent and regular names.
  13. Avoid magic numbers.
  14. Don't optimize prematurely. Benchmark before you optimize. Comment why you are optimizing.
  15. Agree upon a coherent layout style and automate it.
  16. Adopt a policy of zero tolerance for warnings and errors. Tools such as Perl::Tidy and Perl::Critic can help here.
  17. Commenting: prefer to make the code obvious; don't belabor the obvious; comments describe what and why not how.
  18. Separate user vs maintainer documentation.
  19. Use a revision control system and single-step automated build/test.
  20. "Always code as if the guy who ends up maintaining your code will be a violent psychopath who knows where you live" (Damian Conway)

Rather than the standards police enforcing a standard on a team, I think it is better to set up a wiki page and encourage all team members to add to it during a code review, or at any time, when they find something that could improve the coding standard. That is, create a vibe of inclusiveness with everyone trying to improve the quality of the shared codebase, not individuals fighting the standards police. And with a focus on real world things that matter, not trivia or dogma. The coding standard should be a living document.

Replies are listed 'Best First'.
Re^2: 20 most important Perl Best Practices
by jffry (Hermit) on Aug 30, 2012 at 18:21 UTC

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://989158]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others having an uproarious good time at the Monastery: (9)
As of 2024-03-28 14:46 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found