Definition
Documentation
Coding Standards
Resources
Developers |
Coding Standards
Why Have Code Conventions?
Code conventions are important to programmers for a number of reasons:
- 80% of the lifetime cost of a piece of software goes to maintenance.
- Hardly any software is maintained for its whole life by the original
author.
- Code conventions improve the readability of the software, allowing
engineers to understand new code more quickly and thoroughly.
- If you ship your source code as a product, you need to make sure
it is as well packaged and clean as any other product you create.
- The use of these guidelines should result in readable code and should
encourage adherence.
- The resulting documentation should be easy to maintain.
- This document should be a living document in that as we discover
better ways to do things, it gets reflected here.
For the conventions to work, every person writing software must conform
to the code
conventions. Everyone.
What is expected of everyone...
- Everyone should read these guidelines.
- Everyone should understand them.
- Everyone should use them.
Then and only then should anyone begin to challenge them*.
*Ultimately, everyone is expected to help refine the rules embodied
in this document.
Read Java
Code Conventions
|