Six Tips for Writing More Comprehensive Code

For a long time I read Jeff Vogel's article “Six ways to write more comprehensible code”, for sure, someone is familiar with it. She had a very big effect on me, in a sense opened her eyes and helped to make my code better.

The article details the examples with the following tips:

1. Be prudent - write comments.
2. Use the # define operator more often. AS OFTEN AS POSSIBLE.
3. Do not give variables names that can be misleading.
4. Check your program for errors. You do make mistakes. Yes, yes, it is you.
5. “Premature optimization is the root of all evil”, - Donald Knuth (Donald Knuth).
6. Do not try to be clever.

original www.ibm.com/developerworks/linux/library/l-clear-code/index.html
translation www.ibm.com/developerworks/ru/library/l-clear-code/index.html