From 9f293b3650f7337c1a7bafa002ce181ce04dadba Mon Sep 17 00:00:00 2001
From: real-yfprojects <62463991+real-yfprojects@users.noreply.github.com>
Date: Fri, 14 Jun 2024 12:29:01 +0200
Subject: [PATCH] [docs] List a few alternative projects

This adds a new page to the documentation that lists a few alternative
tools that serve the same purpose as `sphinx-polyversion`.

* docs/sphinx/alternatives.rst: bullet list

* docs/sphinx/index.rst: Add a link to the new page.
---
 docs/sphinx/alternatives.rst | 8 ++++++++
 docs/sphinx/index.rst        | 1 +
 2 files changed, 9 insertions(+)
 create mode 100644 docs/sphinx/alternatives.rst

diff --git a/docs/sphinx/alternatives.rst b/docs/sphinx/alternatives.rst
new file mode 100644
index 0000000..4aa89e8
--- /dev/null
+++ b/docs/sphinx/alternatives.rst
@@ -0,0 +1,8 @@
+------------
+Alternatives
+------------
+
+- `sphinx-multiversion <https://github.com/Holzhaus/sphinx-multiversion>`_ (unmaintained)
+- `sphinxcontrib-versioning <https://github.com/sphinx-contrib/sphinxcontrib-versioning>`_ (unmaintained)
+- `sphinx_simpleversion <https://github.com/isaksamsten/sphinx_simpleversion>`_
+- `sphinx_versioning <https://github.com/Yihengxiong6/sphinx_versioning>`_
diff --git a/docs/sphinx/index.rst b/docs/sphinx/index.rst
index 163c589..1b60e2c 100644
--- a/docs/sphinx/index.rst
+++ b/docs/sphinx/index.rst
@@ -18,6 +18,7 @@ Table of Contents
 
     guide/installation
     guide/getting-started
+    alternatives
 
 .. toctree::
     :maxdepth: 2