Small doc updates

Minor README fix
Updated doc comments to fix doc gen errors
Merge pull request #19 from splunk/docspass2

Small doc updates