docs: document version compatibility in the installation instructions (#571)

Co-authored-by: pyansys-ci-bot <[email protected]>

Author: ansjmoody

CONTRIBUTORS.md

@@ -16,10 +16,8 @@
 * [ansznavarro](https://github.com/ansznavarro)
 * [Jeff Moody](https://github.com/ansjmoody)
 * [Jorge Martínez](https://github.com/jorgepiloto)
-* [Joshua Moody](https://github.com/jmoody)
 * [Kathy Pippert](https://github.com/PipKat)
 * [Keith Hanson](https://github.com/anskhanson)
-* [khanson](https://github.com/khanson)
 * [Maxime Rey](https://github.com/MaxJPRey)
 * [Miu Lin Edson](https://github.com/ansmedson-ext)
 * [Nayane Fernandes](https://github.com/ansnfernand)

doc/changelog.d/571.documentation.md

@@ -0,0 +1 @@
+docs: document version compatibility in the installation instructions

doc/source/contributing.rst

@@ -171,7 +171,7 @@ archive from the `Releases Page <https://github.com/ansys/pysherlock/releases>`_
 corresponding machine architecture.
 
 Each wheelhouse archive contains all the Python wheels necessary to install PySherlock from scratch on Windows,
-Linux, and MacOS from Python 3.10 to 3.12. You can install this on an isolated system with a fresh Python
+Linux, and MacOS from Python 3.10 to 3.13. You can install this on an isolated system with a fresh Python
 installation or on a virtual environment.
 
 For example, on Linux with Python 3.10, unzip the wheelhouse archive and install it with:

doc/source/getting_started/installation.rst

@@ -4,17 +4,39 @@
 Install packages
 ================
 
-The ``ansys-sherlock-core`` package supports Python 3.10 through Python 3.12 on Windows.
+The ``ansys-sherlock-core`` package supports Python 3.10 through Python 3.13 on Windows and Linux.
 
 To use PySherlock, you must download and install both the ``ansys-api-sherlock``
 and ``ansys-sherlock-core`` packages. By using ``pip``, ``ansys-api-sherlock`` is
-installed as part of ``ansys-sherlock-core``. Run the following to install
-the publicly distributed version of the package.
+installed as part of ``ansys-sherlock-core``.
+Run the following to install the latest publicly distributed version of the package.
 
 .. code::
 
    pip install ansys-sherlock-core
 
+The following table shows the version of PySherlock to use for each release of Sherlock:
+
++------------+----------+
+| PySherlock | Sherlock |
++============+==========+
+| 0.4        | 2024 R1  |
++------------+----------+
+| 0.6        | 2024 R2  |
++------------+----------+
+| 0.8        | 2025 R1  |
++------------+----------+
+| 0.9        | 2025 R2  |
++------------+----------+
+
+To install a specific version of PySherlock, use the following command, where the <version> is one
+of the values in the table above:
+
+.. code::
+
+   pip install ansys-sherlock-core==<version>
+
+
 If you want to install the ``ansys-api-sherlock`` and ``ansys-sherlock-core`` packages
 from its source code directly, follow these instructions.