Fix readthedocs configuration and use Python 3.11

JIRA: RHELWF-9927

.github/workflows/gating.yaml

@@ -42,7 +42,7 @@ jobs:
       - name: Set up Python for documentation build
         uses: actions/setup-python@v4
         with:
-          python-version: "3.8"
+          python-version: "3.11"
 
       - name: Test building documentation with tox
         run: tox -e docs

.readthedocs.yaml

@@ -1,19 +1,19 @@
-# .readthedocs.yaml
 # Read the Docs configuration file
 # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
-
-# Required
+---
 version: 2
 
-# Build documentation in the docs/ directory with Sphinx
 sphinx:
-   configuration: docs/conf.py
+  configuration: docs/conf.py
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.11"
 
-# Optionally set the version of Python and requirements required to build your docs
 python:
-   version: 3.8
-   install:
-   - method: pip
-     path: .
-     extra_requirements:
-     - docs
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs

tox.ini

@@ -63,7 +63,7 @@ commands =
 
 [testenv:docs]
 # Same Python version as in .readthedocs.yaml
-basepython = python3.8
+basepython = python3.11
 changedir = docs
 extras =
     docs