add some explanatory comments
Merge pull request #4 from sourcegraph/comments

Add some comments