Add missing code documentation

[sgibbons]

All code needs to be fully commented. See longingly.expander.Expander.batch_expand() for an example of the degree of documentation required.