added lots of comments to the docs that Luke wrote on the internals of