Fix intersphinx and syntax
Update references
Improvements to docs
Fix Sphinx warning