Fixes for the reported sphinx errors 

Just a resync PR before Basic Usage uploads
AFAIK, unfortunately, yes; I tried it the other way and an annoying break up into two boxes occurs.
It seems that the `.. include:: <file>` directive is breaking up the defined "element" in half...