Artifacts > Environment Artifact Set > {More Environment Artifacts} > Programming Guidelines > rup_prggd.htm

<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.       Introduction         

1.1     Purpose     

1.2     Scope     

1.3     Definitions, Acronyms and Abbreviations     

1.4     References     

1.5     Overview     

2.       Code Organization and Style

3.       Comments

4.       Naming

5.       Declaration         

6.       Expressions and Statements   

7.       Memory Management

8.       Error Handling and Exception      

9.       Portability

10.      Reuse               

11.      Compilation issues               

12.      Annex: Summary of Guidelines               


Programming Guidelines

1.                  Introduction

[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.]

1.1               Purpose

[Specify the purpose of the Programming Guidelines.]

1.2               Scope

[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.]

1.3               Definitions, Acronyms and Abbreviations

[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.]

1.4               References

[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.]

1.5               Overview

[This subsection should describe what the rest of the Programming Guidelines contains and explain how the document is organized.]

2.                  Code Organization and Style

[A description of the size of a module, layout of a module, space, nesting, legibility, and so on.]

3.                  Comments

[A description of the use of comments.]

4.                  Naming

[A description of how each kind of entity (such as types, variables, and subprograms) should be named.]

5.                  Declaration

[A description of how declarations should be written.]

6.                  Expressions and Statements

[A description of how expressions and statements should be written.]

7.                  Memory Management

[A description of how memory should be managed.]

8.                  Error Handling and Exception

[This section gives rules and guidelines on how error handling and exceptions should be handled.]

9.                  Portability

[This section describes special rules to ensure portability across different platforms and compilers.]

10.             Reuse

[This section gives rules and guidelines to foster easier reuse.]

11.             Compilation issues

[This section describes dependencies between modules, compiler directives, and so on.]

12.             Annex: Summary of Guidelines

[This section summarizes all guidelines; one line for each.]