It’s Harder to Read Code Than It Is to Write It

22 December 2021 by Phillip Johnston • Last updated 29 October 2024We often hear the advice that “well written code doesn’t need documentation” or “write code so that comments are unnecessary”. These statements ignore the fact that code is much harder to read than it is to write, even for skilled and experienced developers. As you’re writing code, it all makes sense in your head. You have all of the details at the top of your minds. You have a clear picture of the problem you’re solving and the reason you chose that particular implementation. The “self-documenting code” you’ve produced …

Continue reading “It’s Harder to Read Code Than It Is to Write It”