Remove ibmsce pages from docs configuration

This driver was removed from salt-cloud, but the references to it in the
docs were not.
Fix sphinx warnings/errors
Fix broken links and other sphinx errors
Add best_practices page to docs
Merge pull request #11307 from terminalmage/docs

Docs housekeeping