Difference between revisions of "Cpp Coding Standards/CODEDOC/ClearBehave"
From Apache OpenOffice Wiki
m (Cpp Coding Standards/Code Documentation/ClearBehave moved to Cpp Coding Standards/CODEDOC/ClearBehave: consistency) |
B michaelsen (Talk | contribs) |
||
Line 2: | Line 2: | ||
On the other hand some facts about each function have to be unambiguously clear: Preconditions, postconditions, possibly invariants, and the behaviour in error cases. If any of these stay unclear, documentation is necessary. | On the other hand some facts about each function have to be unambiguously clear: Preconditions, postconditions, possibly invariants, and the behaviour in error cases. If any of these stay unclear, documentation is necessary. | ||
+ | [[Category:Coding Standards]] |
Latest revision as of 17:06, 14 December 2009
Writing documentation is a tedious and - for many – unpleasant task and it takes time. To have more time for the important comments, leave out the unnecessary. A good function name often can spare many lines of documentation.
On the other hand some facts about each function have to be unambiguously clear: Preconditions, postconditions, possibly invariants, and the behaviour in error cases. If any of these stay unclear, documentation is necessary.