The challenge I have these days is deciding what belongs in code and what goes into design documentation and technical manuals. I generally find that comments

The challenge I have these days is deciding what belongs in code and what goes into design documentation and technical manuals. I generally find that comments in code should explain why the code is doing non-obvious things. “This gets memoized because it’s actually important to maintain referential identity for reason X.”