doc: Use extlinks for linking to issues and PRs

doc/conf.py

@@ -82,6 +82,7 @@ version_txt = get_version(Path(doc_path).absolute().parent)
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
+    "sphinx.ext.extlinks",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -115,6 +116,11 @@ highlight_language = 'none'
 
 smartquotes = False
 
+extlinks = {
+    "issue": ("https://github.com/polybar/polybar/issues/%s", "#%s"),
+    "pull": ("https://github.com/polybar/polybar/pull/%s", "PR #%s"),
+}
+
 
 # -- Options for HTML output -------------------------------------------------
 

doc/dev/release-workflow.rst

@@ -216,8 +216,7 @@ After-Release Checklist
 * Make sure all the new functionality is documented on the wiki
 * Mark deprecated features appropriately (see `Deprecations`_)
 * Remove all unreleased notes from the wiki (not for patch releases)
-* Inform packagers of new release in `#1971
-  <https://github.com/polybar/polybar/issues/1971>`_. Mention any dependency
+* Inform packagers of new release in :issue:`1971`. Mention any dependency
   changes and any changes to the build workflow. Also mention any new files are
   created by the installation.
 * Create a PR that updates the AUR ``PKGBUILD`` file for the ``polybar-git``