The Psychology of Quality and More |
Part 2 : Commenting and Naming
The comments around the code and the names of identifiers used within the code together constitute the readable English in a program. Individually and collectively they explain to the reader what is happening. The comments allow explanation around a point, setting the context and giving reasons for what is about to happen or has just happened. The identifiers are more succinct, being constrained to being a part of the code, but which when well named can make the code read clearly and make its operation and purpose more understandable. It is thus well worth the additional effort required to make the code and comments literally more readable.
|
Site Menu |
Quality: | Quality Toolbook | Tools of the Trade | Improvement Encyclopedia | Quality Articles | Being Creative | Being Persuasive | |
And: | C Style (Book) | Stories | Articles | Bookstore | My Photos | About | Contact | |
Settings: | Computer layout | Mobile layout | Small font | Medium font | Large font | Translate | |
You can buy books here |
And the big |