From 23b1f87ef6f359cdae8a4a55e274da1bca73bd69 Mon Sep 17 00:00:00 2001
From: Kevin Adler <kadler@us.ibm.com>
Date: Tue, 10 Oct 2023 10:03:59 -0500
Subject: [PATCH] docs: Remove deprecated attributes from RtD config

The build.os attribute is now required and configs without it will fail
to build starting on October 16. See
https://blog.readthedocs.com/use-build-os-config/

Also migrate Python version from python.version to build.tools.python as
the former is also deprecated.

Also add nodejs config to install jsdoc, needed by sphinx-js.
---
 .readthedocs.yml | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 05a8e0c6..41338d10 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -5,12 +5,21 @@
 # Required
 version: 2
 
+build:
+  os: "ubuntu-22.04"
+  tools:
+    python: "3.7"
+    nodejs: "20"
+  jobs:
+    post_install:
+      # Install jsdoc prior to build, needed by sphinx-js
+      - npm install -g jsdoc
+
 # Build documentation in the docs/ directory with Sphinx
 sphinx:
   configuration: docs/conf.py
 
 # Optionally set the version of Python and requirements required to build your docs
 python:
-  version: 3.7
   install:
     - requirements: docs/requirements.txt