9954 shaares
261 private links
261 private links
But you have all this internal context that makes it self-documenting. Other people don’t have that context.
I agree
Operational information is more global, how the code fits in with the larger program. The code’s behavior can’t tell us that because it isn’t supposed to know anything about the larger program.
How should we document them?
A list of how self-documenting code is so appealing to people for wrong reasons.
s