From a7bb688c393f8177aa54766194845608dd3338ff Mon Sep 17 00:00:00 2001
From: Rob Redpath <rob.redpath@opendataservices.coop>
Date: Fri, 30 Jan 2026 09:39:48 +0000
Subject: [PATCH] bugfix: make local build closer match rtd by using dirhtml

---
 .vscode/launch.json | 3 ++-
 README.rst          | 2 +-
 requirements.in     | 1 +
 3 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/.vscode/launch.json b/.vscode/launch.json
index 53494f2..9ed20c2 100644
--- a/.vscode/launch.json
+++ b/.vscode/launch.json
@@ -7,10 +7,11 @@
             "request": "launch",
             "module": "sphinx_autobuild",
             "args": [
+                "-b", "dirhtml",
                 "docs",
                 "docs/_build/html"
             ],
             "justMyCode": false
         }
     ]
-}
\ No newline at end of file
+}
diff --git a/README.rst b/README.rst
index 7f15cc7..f0b6585 100644
--- a/README.rst
+++ b/README.rst
@@ -85,7 +85,7 @@ Assuming a unix based system:
   pip install -r requirements_dev.txt
   
   # Run sphinx-autobuild
-  sphinx-autobuild docs docs/_build/html
+  sphinx-autobuild -b dirhtml docs docs/_build/html
 
 Then go to http://localhost:8000/ in a browser.
 When you save changes to a file, it should update in the browser automatically.
diff --git a/requirements.in b/requirements.in
index 5e2b1ce..38e66eb 100644
--- a/requirements.in
+++ b/requirements.in
@@ -1,6 +1,7 @@
 sphinx
 sphinx-togglebutton
 sphinxcontrib-opendataservices
+sphinxcontrib-redoc
 sphinxcontrib-video
 sphinxcontrib-youtube
 sphinx-intl