The short answer is yes, usually. In most coding standards and guidelines I have worked with (and developed) over the decades, the use abbreviations and acronyms in identifiers (e.g., in variable names, function names, type names, class names, structure names, …
Read moreWhy should I add comments to my code?
Good comments convey important information to the human reader of the code that the code cannot clearly convey by itself. Comments should add value, making the code easier to understand, and therefore more maintainable. Remember that 80% of the cost …
Read moreShould I obscure my source code to make it more secure?
In a word, no. Obscuring your source code has no benefit in the real world. When you write code, you are not only expressing your intent to the compiler, but you’re also expressing your intent the the human reader — …
Read moreWriting Code that Humans Can Understand
I’m often asked why I put so much emphasis on writing code that contains relevant comments, code that is readable, and code that is maintainable. After all, isn’t it enough to get the project to build properly and pass any required test …
Read more