Next: High Integrity CPP Guideline 2.2  Up: 2 General  Previous: 2 General  Contents

High Integrity CPP Rule 2.1   Thoroughly document in the code any deviation from a standard rule.

Justification

This standard addresses most situations, however a specific situation may require deviation from the standard introducing unexpected anomalies in system behaviour or affecting other system qualities. Since there are usually several ways to address such requirements, it is important to consider the benefits and drawbacks of each approach. Alternatives should be documented so that approaches are not taken, during maintenance, that have already been discarded. All the consequences of the choice should be documented so that correct assumptions can be made in maintenance.


HICPP VERSION 2.4  http://www.codingstandard.com   Copyright: © 2007 THE PROGRAMMING RESEARCH GROUP