DOC: Fix formatting.
DOC: Fix broken links.
DOC: Make sure release placeholders is short version
DOC: Remove redundant and outdated information.
DOC: Add FAQ page
Merge pull request #1527 from jseabold/update-docs

DOCS: Update docs add FAQ page
DOC: Fix link
Merge pull request #1530 from jseabold/fix-link

DOC: Fix link
DOC: Fix link.
DOC: Ran linkcheck. Fixed links.
Merge pull request #1531 from jseabold/fix-links

DOC: Fix stale links with linkcheck
DOC: Fix link to code on github
Merge pull request #1533 from jseabold/fix-gh-links

DOC: Fix link to code on github
CLN: Improve warnings to avoid generic warnings messages

All generic Warnings have been replaced with specific warnings, which have
been consolidated into sm_exceptions.py.