Highlights - Code Comments⚑

• If the code is confusing – I try to refactor the code so that it’s not confusing anymore.¹
• If a refactoring is not possible, I document the “why”, not the “how”. The “how” is already documented: that’s the code.¹
• The majority of my time as a developer will be spent reading and deciphering existing code. I need to be able to do this as quickly as possible to be efficient. If a comment helps me grok something quickly due to some weird edge-case complexity, then the comment is worth its weight in gold.¹