<Project Name>
Programming Guidelines
Version <1.0>
[Note: The following template is provided for use with the Rational Unified Process. Text enclosed in square brackets and displayed in blue italics (style=InfoBlue) is included to provide guidance to the author and should be deleted before publishing the document. A paragraph entered following this style will automatically be set to normal (style=Body Text).]
Revision History
Date |
Version |
Description |
Author |
<dd/mmm/yy> |
<x.x> |
<details> |
<name> |
|
|
|
|
|
|
|
|
|
|
|
|
Table of Contents
1.3 Definitions, Acronyms and Abbreviations
2. Code Organization and Style
8. Error Handling and Exception
12. Annex: Summary of Guidelines
Programming Guidelines
[The introduction of the Programming Guidelines should provide an overview of the entire document. It should include the purpose, scope, definitions, acronyms, abbreviations, references, and overview of the Programming Guidelines.]
[Specify the purpose of the Programming Guidelines.]
[A brief description of the scope of the Programming Guidelines; what Project(s) it is associated with, and anything else that is affected or influenced by this document.]
[This subsection should provide the definitions of all terms, acronyms, and abbreviations required to properly interpret the Programming Guidelines. This information may be provided by reference to the project Glossary.]
[This subsection should provide a complete list of all documents referenced elsewhere in the Programming Guidelines. Each document should be identified by title, report number (if applicable), date, and publishing organization. Specify the sources from which the references can be obtained. This information may be provided by reference to an appendix or to another document.]
[This subsection should describe what the rest of the Programming Guidelines contains and explain how the document is organized.]
[A description of the size of a module, layout of a module, space, nesting, legibility, and so on.]
[A description of the use of comments.]
[A description of how each kind of entity (such as types, variables, and subprograms) should be named.]
[A description of how declarations should be written.]
[A description of how expressions and statements should be written.]
[A description of how memory should be managed.]
[This section gives rules and guidelines on how error handling and exceptions should be handled.]
[This section describes special rules to ensure portability across different platforms and compilers.]
[This section gives rules and guidelines to foster easier reuse.]
[This section describes dependencies between modules, compiler directives, and so on.]
[This section summarizes all guidelines; one line for each.]