Sphinx docs

.github/workflows/get_schema_on_tag.yml

@@ -18,7 +18,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: '3.12'
+          python-version: "3.12"
 
       - name: Install dependencies
         run: |

.github/workflows/test-critical-high.yml

@@ -17,7 +17,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: "3.11"
+          python-version: "3.12"
 
       - name: install
         run: |

.github/workflows/test-medium-low.yml

@@ -14,7 +14,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version: "3.11"
+          python-version: "3.12"
 
       - name: install
         run: |

.gitignore

@@ -12,4 +12,7 @@ converage.xml
 .pytest_cache/
 **/.DS_Store
 
-*.egg-info/
+*.egg-info/
+
+# Sphinx stuff to ignore
+_build/

.readthedocs.yaml

@@ -0,0 +1,44 @@
+# Read the Docs configuration file for Sphinx projects
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+
+# Set the OS, Python version and other tools you might need
+build:
+  os: ubuntu-lts-latest
+  tools:
+    python: "3.12"
+
+    # You can also specify other tool versions:
+    # nodejs: "20"
+    # rust: "1.70"
+    # golang: "1.20"
+
+
+# Build documentation in the "docs/" directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+  # You can configure Sphinx to use a different builder, for instance use the dirhtml builder for simpler URLs
+  # builder: "dirhtml"
+  # Fail on all warnings to avoid broken references
+  # fail_on_warning: true
+
+# Optionally build your docs in additional formats such as PDF and ePub
+# formats:
+#   - pdf
+#   - epub
+
+
+# Optional but recommended, declare the Python requirements required
+# to build your documentation
+
+# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
+
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs

CITATION.cff

@@ -112,5 +112,5 @@ keywords:
     - crf
     - data capture
 license: MIT
-version: 1.3.0
-date-released:
+version: 1.2.2
+date-released: April 2026

README.md

@@ -1,3 +1,7 @@
+[![CodeQL](https://github.com/ISARICResearch/ARC/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/ISARICResearch/ARC/actions/workflows/github-code-scanning/codeql)
+[![Run tests marked as medium or low](https://github.com/ISARICResearch/ARC/actions/workflows/test-medium-low.yml/badge.svg)](https://github.com/ISARICResearch/ARC/actions/workflows/test-medium-low.yml)
+[![Run tests marked as critical or high](https://github.com/ISARICResearch/ARC/actions/workflows/test-critical-high.yml/badge.svg)](https://github.com/ISARICResearch/ARC/actions/workflows/test-critical-high.yml)
+[![Docs](https://app.readthedocs.org/projects/isaric-arc/badge/?version=latest)](https://app.readthedocs.org/projects/isaric-arc/builds/?version__slug=latest)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 # ARC - Analysis and Research Compendium

docs/Makefile

@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/_static/css/custom.css

@@ -0,0 +1,3 @@
+.theme-toggle-container {
+  display: none;
+}