Improve and update documentation

 * Tweak documentation in a number of places.
 * Add brief package level documentation. Closes #221.
 * Fix scaladoc references (no more warnings).
Tweak documentation in windowing package.
Merge pull request #252 from hammerlab/improve-docs

Improve and update documentation