Address ReadTheDocs build error (since Aug 2023)

.readthedocs.yaml

@@ -0,0 +1,12 @@
+version: 2
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.12"
+python:
+  install:
+    - requirements: docs/requirements.txt
+sphinx:
+  configuration: docs/conf.py
+  builder: html
+  fail_on_warning: true

docs/conf.py

@@ -62,7 +62,7 @@
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = "en"  # The old value None will fallback to "en" with a warning
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -95,7 +95,7 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+html_static_path = []  # ['_static']
 
 # Custom sidebar templates, must be a dictionary that maps document names
 # to template names.

docs/index.rst

@@ -2,16 +2,20 @@ Identity Documentation
 ======================
 
 .. The following summary is reused in, and needs to be in-sync with, the ../README.md
+
 This Identity library is an authentication/authorization library that:
 
 * Suitable for apps that are targeting end users on
   `Microsoft identity platform <https://learn.microsoft.com/en-us/azure/active-directory/develop/v2-overview>`_.
   (which includes Work or school accounts provisioned through Azure AD,
   and Personal Microsoft accounts such as Skype, Xbox, Outlook.com).
+
 * Currently designed for web apps,
   regardless of which Python web framework you are using.
+
 * Provides a set of high level API that is built on top of, and easier to be used than
   `Microsoft's MSAL Python library <https://github.com/AzureAD/microsoft-authentication-library-for-python>`_.
+
 * Written in Python, for Python apps.
 
 .. toctree::