Clean Code

• Clean = Readable + Maintainable: Clean code is a set of technical practices for writing code that is readable, i.e., easy to understand, and maintainable, i.e., cheap to change. Both of these aspects reduce the overall programming effort required for future work. Whenever possible, code should be kept both readable and maintainable, which is most often the case, since the two usually go hand in hand.
• Readable > Maintainable: However, when the two are in conflict, readability is often more important than maintainability, since code is read more often than it is written. The benefit of making code easier to read is simply greater than the benefit of making code easier to modify. For example, duplication is harder to maintain, but is often the lesser of two evils if it makes the code more readable, when there is no way to get both aspects right.

Topics