If something is cumbersome to reason about, chances are it’s implemented incorrectly. Exception is when you are reading code that resulted from isolating complexity, in which case reading the comments in full before reading the code may be a good way to proceed. Incidentally, if there are no such comments, yet you’ve invested the time to wrap your head around what’s going on, now is the perfect time to write the comments, unless you have the cycles to refactor and clean up the code to make it easily understandable and self-documenting.
Comments
Post a Comment