en:devmon:guidelines:20bestpractices
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
en:devmon:guidelines:20bestpractices [2021/08/19 07:22] – adminw1k1 | en:devmon:guidelines:20bestpractices [2021/08/19 07:29] (current) – adminw1k1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== 20 most important Perl Best Practices ====== | + | ====== 20 Best Practices ====== |
- | - Correctness, | + | - **Correctness**, **simplicity** and **clarity** come first. |
- | - Avoid unnecessary cleverness. If you must rely on cleverness, encapsulate and comment it. | + | - Avoid unnecessary |
- Avoid duplication ([[http:// | - Avoid duplication ([[http:// | ||
- Coupling and Cohesion. Systems should be designed as a set of cohesive modules as loosely coupled as is reasonably feasible. | - Coupling and Cohesion. Systems should be designed as a set of cohesive modules as loosely coupled as is reasonably feasible. | ||
Line 18: | Line 18: | ||
- Commenting: prefer to make the code obvious; don't belabor the obvious; comments describe what and why not how. | - Commenting: prefer to make the code obvious; don't belabor the obvious; comments describe what and why not how. | ||
- Separate user vs maintainer documentation. | - Separate user vs maintainer documentation. | ||
- | - Use a revision control system and single-step automated build/ | + | - Use a revision control system |
- | - " | + | - **" |
en/devmon/guidelines/20bestpractices.1629350562.txt.gz · Last modified: 2021/08/19 07:22 by adminw1k1