Go back to Richel Bilderbeek's homepage.

Go back to Richel Bilderbeek's C++ page.

(C++) documentation

Document the interfaces so that they are usable by others [1]. Explicitly state conditions under which behavior is undefined [2]. The use of assert statements can help to document the assumptions you make when implementing your code [3].

References

1. John Lakos. Large-Scale C++ Software Design. 1996. ISBN: 0-201-63362-0. Chapter 2.6: 'Document the interfaces so that they are usable by others. Have at least one other developer review each interface'
2. John Lakos. Large-Scale C++ Software Design. 1996. ISBN: 0-201-63362-0. Chapter 2.6: 'Explicitly state conditions under which behavior is undefined'
3. John Lakos. Large-Scale C++ Software Design. 1996. ISBN: 0-201-63362-0. Chapter 2.6: 'The use of assert statements can help to document the assumptions you make when implementing your code<'/li>

Go back to Richel Bilderbeek's C++ page.

Go back to Richel Bilderbeek's homepage.