[docs] minor configuration fixes

Author: stonier

.readthedocs.yaml

@@ -16,12 +16,13 @@ build:
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
    configuration: docs/conf.py
+   fail_on_warning: true
 
 # If using Sphinx, optionally build your docs in additional formats such as PDF
 # formats:
 #    - pdf
 
 # Optionally declare the Python requirements required to build your docs
 python:
-   install:
-   - requirements: docs/requirements.txt
+  install:
+    - requirements: docs/requirements.txt

docs/conf.py

@@ -38,9 +38,9 @@
 version = __version__
 release = version
 
+
 ################################################################################
-# General configuration
-# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+# Extensions
 ################################################################################
 
 extensions = [
@@ -57,11 +57,6 @@
     "sphinxarg.ext",
 ]
 
-templates_path = ["_templates"]
-exclude_patterns = ["_build", "weblinks.rst"]
-
-language = "en"
-
 ################################################################################
 # Extensions Configuration
 ################################################################################
@@ -72,6 +67,15 @@
 # If you don't add this, todos don't appear
 todo_include_todos = True
 
+################################################################################
+# General configuration
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+################################################################################
+
+templates_path = ["_templates"]
+exclude_patterns = ["_build", "weblinks.rst"]
+language = "en"
+
 ################################################################################
 # HTML
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output