Modularity is the key
When refactoring code, keep in mind that moving logic to smaller discrete files/classes/methods/functions will help you and other humans understand the code better six months from now.
There is always a balance with brevity versus more description that make the balancing act of just enough ceremony to allow for the next coder to understand what is being looked at.
Written on May 29, 2020