diff --git a/docs/CodingStandards.html b/docs/CodingStandards.html index b5946a42284..35ead311fc6 100644 --- a/docs/CodingStandards.html +++ b/docs/CodingStandards.html @@ -111,7 +111,7 @@ href="mailto:sabre@nondot.org">Chris.

Comments are one critical part of readability and maintainability. Everyone -knows they should comment, so should you. :) Although we all should probably +knows they should comment, so should you. Although we all should probably comment our code more than we do, there are a few very critical places that documentation is very useful:

@@ -164,7 +164,7 @@ included, as well as any notes or "gotchas" in the code to watch out for.

a class definition should have a comment block that explains what the class is used for... if it's not obvious. If it's so completely obvious your grandma could figure it out, it's probably safe to leave it out. Naming classes -something sane goes a long ways towards avoiding writing documentation. :)

+something sane goes a long ways towards avoiding writing documentation.

Method information @@ -194,7 +194,7 @@ when it is useful to use C style (/* */) comments however:

  1. When writing a C code: Obviously if you are writing C code, use C style - comments. :)
  2. + comments.
  3. When writing a header file that may be #included by a C source file.
  4. When writing a source file that is used by a tool that only accepts C @@ -470,7 +470,7 @@ about later...

    Many modules have a complex implementation that causes them to use more than one implementation (.cpp) file. It is often tempting to put the internal communication interface (helper classes, extra functions, etc) in the -public module header file. Don't do this. :)

    +public module header file. Don't do this.

    If you really need to do something like this, put a private header file in the same directory as the source files, and include it locally. This ensures @@ -594,8 +594,7 @@ good way to avoid documentation, and avoid giving bugs a place to hide.

    For these reasons, come to know and love the contents of your local <algorithm> header file. Know about <functional> -and what it can do for you. C++ is just a tool that wants you to master it. -:)

    +and what it can do for you. C++ is just a tool that wants you to master it.

@@ -625,7 +624,7 @@ Software Design by John Lakos

If you get some free time, and you haven't read them: do so, you might learn -something. :)

+something.