Why Coding Conventions?

See Also

The main reason for using a consistent set of coding conventions is to standardize the structure and coding style of an application so that you and others can easily read and understand the code.

Good coding conventions result in precise, readable, and unambiguous source code that is consistent with other language conventions and as intuitive as possible.

Minimal Coding Conventions

A general-purpose set of coding conventions should define the minimal requirements necessary to accomplish the purposes discussed above, leaving the programmer free to create the program’s logic and functional flow.

The object is to make the program easy to read and understand without cramping the programmer’s natural creativity with excessive constraints and arbitrary restrictions.

To this end, the conventions suggested in this appendix are brief and suggestive. They do not list every possible object or control, nor do they specify every type of informational comment that could be valuable. Depending on your project and your organization’s specific needs, you may wish to extend these guidelines to include additional elements, such as:

• Conventions for specific objects and components developed in-house or purchased from third-party vendors.
  
  
• Variables that describe your organization’s business activities or facilities.
  
  
• Any other elements that your project or enterprise considers important for clarity and readability.

For more information   For information about restrictions on naming procedures, variables, and constants, see "Code Basics" in "Programming Fundamentals."