Coding: Six ways to write more comprehensible code

June 2nd, 2007 by Richy B. Leave a reply »

From IBM there’s the Six ways to write more comprehensible code – How to keep your code from destroying you. Usefully it provides examples for:

  1. Comment like a smart person
  2. Use #define a lot. No, a LOT
  3. Don’t use variable names that will mock you
  4. Do error checking. You make errors. Yes, you
  5. “Premature optimization is the root of all evil.” – Donald Knuth
  6. Don’t be too clever by half.

This post is over 6 months old.

This means that, despite my best intentions, it may no longer be accurate.

This blog holds over 12 years of archived content - during that time, I may have changed my opinion of something, technology will have advanced (and old "best standards" may no longer be the case), my technology "know how" has improved etc etc - it would probably take me a considerable amount of time to update all the archival entries: and defeat the point of keeping them anyway.

Please take these posts for what they are: a brief look into my past, my history, my journey and "caveat emptor".

Leave a Reply

%d bloggers like this: