Fixes for the reported sphinx errors 

Just a resync PR before Basic Usage uploads
no, please don't include outdated or partial documentation here... having this point to the wiki is an incentive to clean it up here, and get rid of the wiki page