alt Hacker NewsI understand the point, but shouldn't the code be documented and well structured so that the intent is clear without looking at the discussion around changes?
I'm working on a legacy system right now - I'd commit several felonies just to have well documented code, I don't really care about all the conversations that the original team had to decide what they eventually did.
Maybe I'm just too old and don't get it.
surely you could imagine that being able to sit in on a meeting that was had when they were designing the system would be useful for you?
theres a lot of context and decision making that is useful but not documented in the code. The code tells you how the system works, not how its supposed to work.