DOC: Fixed warnings from sphinx and corrected two links.
DOC: Included missing file in documentation and corrected syntax.