TODO reduction + Documentation update

In short, documented code and reviewed TODOs, eliminating or adding TODOs in the process. Net reduction: 7, from 35 to 28

Signed-off-by: David Noble <dnoble@splunk.com>