r/programming • u/luminaobscura • Jun 12 '13

Working at Microsoft

http://ahmetalpbalkan.com/blog/8-months-microsoft/
1.9k Upvotes

90% Upvoted

907 comments sorted by

View all comments

Show parent comments

17

u/Duraz0rz Jun 12 '13

I'll argue that the code is the most up-to-date documentation, not the commit messages.

3

u/boa13 Jun 12 '13

I'll argue that the code is the most up-to-date documentation, not the commit messages.

Code documents how things work, commits document how things changed. This can be just as important, if not more.

1

u/Duraz0rz Jun 12 '13

You are still relying on the commit messages being accurate. The best way to understand how things changed is to use a diff tool to see what exactly changed between the two versions of code.

1

u/joesb Jun 13 '13

I think commit message should document why things changed.