Merge pull request #218 from shenxianpeng/update-docs

feat: use `sphinx-issues` for linking

Author: takluyver

docs/changelog.rst

@@ -5,9 +5,9 @@ v1.2
 ----
 
 - Improve interoperability with ``importlib.metadata``, fixing a regression
-  in setuptools compatibility in 1.1 (#199).
+  in setuptools compatibility in 1.1 (PR :pr:`199`).
 - Clean up the ``_in_process`` directory inside the package from ``sys.path``
-  before imporing the backend (#193).
+  before imporing the backend (PR :pr:`193`).
 
 v1.1
 ----
@@ -39,7 +39,7 @@ v0.13
 
 - Remove support for end-of-life Pythons. Now requires Python3.6+.
 - Remove support for ``toml`` package. Now requires ``tomli``.
-- Rely on preferred "files" API on Python 3.9 and later (#140).
+- Rely on preferred "files" API on Python 3.9 and later (:issue:`140`).
 
 v0.12
 -----

docs/conf.py

@@ -16,7 +16,7 @@
 extensions = [
     "sphinx.ext.autodoc",
     "sphinx.ext.intersphinx",
-    "sphinx.ext.extlinks",
+    "sphinx_issues",
 ]
 
 toc_object_entries_show_parents = "hide"
@@ -46,6 +46,4 @@
 # -- Options for extlinks ----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html#configuration
 
-extlinks = {
-    "pypi": ("https://pypi.org/project/%s", "%s"),
-}
+issues_github_path = "pypa/pyproject-hooks"

docs/requirements.txt

@@ -1,2 +1,3 @@
 furo
 sphinx
+sphinx-issues