diff --git a/build-docs.sh b/build-docs.sh
new file mode 100755
index 0000000000000000000000000000000000000000..00eede5c272285774ee9f4dc0af192afb2835520
--- /dev/null
+++ b/build-docs.sh
@@ -0,0 +1,8 @@
+python docs/dump-openapi-spec.py
+
+# to render the diagrams:
+#   pip install -r docs/requirements-er.txt
+#   ... and install dot on the system
+# python docs/render_db_diagrams.py
+
+sphinx-build -M html docs/source docs/build