{"tags":["software"],"explanation":"
In my experience, the greatest technical debt is accumulated by developers in\ntoo much of a hurry or too lazy to write code well. The irony is that their\npeers often can be heard saying things like, “Steve’s code is so good, no one\ncan understand it.” That’s not how this works.
\n\nGood complex code is broken down into easy to read segments, which are commented\nbriefly to describe why the code does what it does in each segment. These\nsegments are grouped into larger abstractions. This is very similar to how a\nlarge book is written: sentences, paragraphs, sections, chapters, parts,\nvolumes. Alternatively, you could just throw a jumble of notes containing the\nsame information into a notebook, but no one will be able to understand it.\nDon’t do that with your code either.
\n","truth":"If your code is unreadable, what makes you think your comments will be more helpful?","key":"75"}