Re: [PATCH 0/6] Add a bunch of docstrings and make a few minor cleanups

2014-02-24 Thread Junio C Hamano
Michael Haggerty mhag...@alum.mit.edu writes: I was reading around in the neighborhood of fsck, objects, and packs and I had the familiar and discouraging experience of having to read code all the way up and down the callstack to understand *anything*. Please let's all make more of an effort

[PATCH 0/6] Add a bunch of docstrings and make a few minor cleanups

2014-02-21 Thread Michael Haggerty
I was reading around in the neighborhood of fsck, objects, and packs and I had the familiar and discouraging experience of having to read code all the way up and down the callstack to understand *anything*. Please let's all make more of an effort to document functions, especially things that are