Add Intersphinx and test link

Signed-off-by: Ayan Sinha Mahapatra <ayansmahapatra@gmail.com>

Author: AyanSinhaMahapatra

docs/source/conf.py

@@ -36,8 +36,12 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
+'sphinx.ext.intersphinx'
 ]
 
+# Temporary Mapping, Once scancode-toolkit.readthedocs.io has the migrated docs, this can be changed to the same.
+intersphinx_mapping = {'scancode-toolkit': ('https://sphinx-test-ayan.readthedocs.io/en/scancode-toolkit/', None)}
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 

docs/source/doc_maintenance.rst

@@ -102,8 +102,10 @@ examples::
 The AboutCode webhook with ReadTheDocs should rebuild the documentation. You can review your
 results online.
 
+.. _doc_style_guide:
+
 Documentation Style Guides
 --------------------------
 
 The ``scancode-toolkit`` documentation is compliant to our doc style standards, enforced using
-``doc8``. For more details refer :ref:`contrib_doc_dev`.
+``doc8``. For more details refer :ref:`scancode-toolkit:contrib_doc_dev`.