doc tweaks
implement feedback
merged branch vicb/doc (PR #619)

This PR was merged into the master branch.

Commits
-------

79d40ae implement feedback
4e36a6a doc tweaks

Discussion
----------

minor doc tweaks

---------------------------------------------------------------------------

by vicb at 2013-02-07T10:30:20Z

@igorw fixed, thanks.