Add documentation on python-environment GithubAction (#177)

Author: Nicoretti

doc/changes/unreleased.md

@@ -12,6 +12,7 @@ For additional information, refer to [customization](../user_guide/customization
 
 ## 📚 Documentation
 * Added documentation on nox task plugins for users and developers.
+* Added documentation on python-environment action.
 * Updated theme and structure of the documentation.
 
 ## 🔩 Internal

doc/github_actions/github_actions.rst

@@ -6,4 +6,5 @@
 .. toctree::
     :maxdepth: 2
 
+    python_environment
     security_issues

doc/github_actions/python_environment.rst

@@ -0,0 +1,48 @@
+python-environment
+==================
+This action prepares everything related to Python for the project to run or to be tested. It involves installing the Python interpreter and Poetry. It also includes creating and activating a Poetry environment, as well as installing the project dependencies, and the project itself, into the Poetry environment.
+
+Parameters
+----------
+.. list-table::
+   :header-rows: 1
+
+   * - Parameter
+     - Description
+     - Required
+     - Default
+   * - python-version
+     - Python version to use
+     - True
+     - 3.8
+   * - poetry-version
+     - Poetry version to use
+     - True
+     - 1.2.2
+
+Example Usage
+-------------
+
+.. code-block:: yaml
+
+    name: Checks
+
+    ...
+
+    jobs:
+
+      test-job:
+        name: Tests
+        runs-on: ubuntu-latest
+
+        steps:
+          - name: SCM Checkout
+            uses: actions/checkout@v3
+
+          - name: Setup Python & Poetry Environment
+            uses: exasol/python-toolbox/.github/actions/python-environment@0.9.0
+            with:
+              python-version: 3.12
+              poetry-version: 1.2.2
+
+            ...