docs: fix doc linking (#6)

Author: ianhi

.gitignore

@@ -106,3 +106,4 @@ ENV/
 
 mpl_arrow/_version.py
 src/mpl_arrow/_version.py
+docs/api

README.md

@@ -3,7 +3,7 @@
 [![Python Version](https://img.shields.io/pypi/pyversions/mpl-arrow.svg?color=green)](https://python.org)
 [![CI](https://github.com/mpl-extensions/mpl-arrow/actions/workflows/ci.yml/badge.svg)](https://github.com/mpl-extensions/mpl-arrow/actions/workflows/ci.yml)
 [![codecov](https://codecov.io/gh/mpl-extensions/mpl-arrow/branch/main/graph/badge.svg)](https://codecov.io/gh/mpl-extensions/mpl-arrow)
-[![Documentation Status](https://readthedocs.org/projects/mpl-arrow/badge/?version=stable)](https://mpl-arrow.readthedocs.io/en/stable/?badge=stable)
+[![Documentation Status](https://readthedocs.org/projects/mpl-arrow/badge/?version=stable)](https://mpl-arrow.readthedocs.io/en/stable/)
 
 # mpl-arrow
 A simpler way to draw nice arrows in matplotlib

docs/conf.py

@@ -42,7 +42,7 @@
             "--no-toc",
             "--templatedir _templates",
             "--separate",
-            "../mpl_arrow/",
+            "../src/mpl_arrow/",
             # excluded modules
             # nothing here for cookiecutter
         ]
@@ -63,6 +63,7 @@
     "sphinx.ext.autodoc",
     "sphinx.ext.inheritance_diagram",
     "autoapi.sphinx",
+    "sphinx.ext.intersphinx",
 ]
 
 # API settings

docs/index.ipynb

@@ -10,7 +10,7 @@
     "Easily plot nice-looking arrows with matplotlib\n",
     "\n",
     "\n",
-    "`mpl-arrow` provides functions for drawing arrows (vectors) between two points in data space. The `arrow` function mimics the api of `~matplotlib.pyplot.arrow` but with defaults that allow the arrow to render nicely. Additionally `arrow_absolute` and `vector` provide alternative function signatures.\n",
+    "`mpl-arrow` provides functions for drawing arrows (vectors) between two points in data space. The {func}`.arrow` function mimics the api of {func}`matplotlib.pyplot.arrow` but with defaults that allow the arrow to render nicely. Additionally {func}`.arrow_absolute` and {func}`.vector` provide alternative function signatures.\n",
     "\n",
     "\n",
     "Key aspects of the functions are that they all:\n",