The TL;DR Rule: How I Structure Files to Not Annoy My Team

Here is a hard truth about our profession: We don’t read code like a novel. We don’t start at line 1 and read strictly to line 10,000, savouring every variable assignment and nuance of syntax. We scan. When you open a documentation page, a Stack Over...