> software evolution is constrained by organizational stability and the ability of developers to understand the system Simple is better than magic and code doc

> software evolution is constrained by organizational stability and the ability of developers to understand the system Simple is better than magic and code documentation is required. Side note: "loop over items and save each" isn't a useful comment right before a for loop. That isn't what I'm talking about. However, "We have to call this API one-at-a-time synchronously because otherwise their internal WAF will block us if we issue parallel requests" is very helpful context when the obvious improvement to the code is multiple threads/async I/O.