beeware · kattni · Oct 10, 2025 · Oct 15, 2025 · Oct 15, 2025 · Oct 15, 2025
diff --git a/.pyspelling.yml b/.pyspelling.yml
@@ -0,0 +1,57 @@
+matrix:
+- name: markdown
+  dictionary:
+    wordlists:
+    - docs/spelling_wordlist
+    output: _build/dictionary/python.dic
+  sources:
+  - 'docs/**/*.md'
+  pipeline:
+  - pyspelling.filters.markdown:
+      markdown_extensions:
+      - markdown.extensions.toc
+      - markdown.extensions.admonition
+      - markdown.extensions.attr_list
+      - pymdownx.superfences
+      - pymdownx.blocks.admonition
+      - pymdownx.blocks.caption
+      - pymdownx.blocks.tab
+      - pymdownx.snippets
+  - pyspelling.filters.html:
+      comments: true
+      attributes:
+        - title
+        - alt
+      ignores:
+        - 'code'
+        - 'pre'
+        - 'figure'  # Can be removed once all <figure>s are replaced with Markdown
+        - 'nospell'  # Allows for ignoring a word or words inline.
+  - pyspelling.filters.context:
+      context_visible_first: true
+      escapes: '\\[\\`~]'
+      delimiters:
+        # Ignores the Jinja directives and their contents
+        - open: '{%'
+          content: '[\d\D]*'
+          close: '%}'
+        # Ignores the Jinja directives and their contents
+        - open: '{{'
+          content: '[\d\D]*'
+          close: '}}'
+        # Ignore the mkdocstrings syntax and its content
+        - open: '\['
+          content: '[\d\D]*\]\[[\d\D]*'
+          close: '\]'
+        # Ignore the mkdocstrings syntax and its content
+        - open: ':::'
+          content: '[\d\D]*'
+          close: '\n'
+        # Ignore the single line Snippets syntax
+        - open: '-8<\-'
+          content: '[\d\D]*'
+          close: '\n'
+        # Ignore the multiline Snippets syntax
+        - open: '-8<\-\n'
+          content: '[\d\D]*'
+          close: '-8<-\n'
diff --git a/.readthedocs.yml b/.readthedocs.yml
@@ -7,35 +7,18 @@ version: 2
 
 # Set the version of Python and other tools you might need
 build:
-  os: ubuntu-22.04
+  os: ubuntu-24.04
   tools:
-    # Docs are always built on Python 3.12. See also the tox config and contribution docs.
+    # Docs are always built on Python 3.12. See also the tox config.
     python: "3.12"
   jobs:
+    post_checkout:
+      - git fetch --unshallow
+    pre_install:
+      - python -m pip install --upgrade pip
+      - python -m pip install --group 'tox-uv'
     pre_build:
-      - tox -e docs-lint
-
-# Build documentation in the docs/ directory with Sphinx
-sphinx:
-  builder: html
-  configuration: docs/conf.py
-  fail_on_warning: true
-
-# Optionally build your docs in additional formats such as PDF
-formats:
-  - epub
-  - pdf
-
-# Set the version of Python and requirements required to build the docs
-python:
-  install:
-  # Docs requirements are *mostly* handled by the `docs` extra; but we can't include
-  # the theme that way, so the theme is installed using a requirements.txt file,
-  # independent of the docs extra. Ideally, we'd use dependency groups for docs
-  # dependencies, but RTD doesn't support them yet.
-  - requirements: requirements-docs.txt
-  - method: pip
-    path: .
-    extra_requirements:
-      - docs
-      - dev
+      - python -m tox -e docs-lint
+    build:
+      html:
+        - python -m tox -e docs-$READTHEDOCS_LANGUAGE -- --output=$READTHEDOCS_OUTPUT/html/
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -0,0 +1,4 @@
+# Changelog
+
+A complete history of the changes to Rubicon can be found in [Rubicon's
+documentation](./docs/background/releases).
diff --git a/changes/628.misc.rst → changes/628.misc.md b/changes/628.misc.rst → changes/628.misc.md
diff --git a/changes/629.misc.md b/changes/629.misc.md
@@ -0,0 +1,2 @@
+The `pre-commit` hook for `pre-commit-hooks` was updated to its latest
+version.
diff --git a/changes/629.misc.rst b/changes/629.misc.rst
diff --git a/changes/630.misc.md b/changes/630.misc.md
@@ -0,0 +1,2 @@
+The `pre-commit` hook for `ruff-pre-commit` was updated to its latest
+version.
diff --git a/changes/630.misc.rst b/changes/630.misc.rst
diff --git a/changes/632.misc.rst → changes/632.misc.md b/changes/632.misc.rst → changes/632.misc.md
diff --git a/changes/633.misc.md b/changes/633.misc.md
@@ -0,0 +1,2 @@
+The `pre-commit` hook for `ruff-pre-commit` was updated to its latest
+version.
diff --git a/changes/633.misc.rst b/changes/633.misc.rst
diff --git a/changes/634.misc.rst → changes/634.misc.md b/changes/634.misc.rst → changes/634.misc.md
diff --git a/changes/635.misc.rst → changes/635.misc.md b/changes/635.misc.rst → changes/635.misc.md
diff --git a/changes/636.misc.md b/changes/636.misc.md
@@ -0,0 +1,2 @@
+The `pre-commit` hook for `ruff-pre-commit` was updated to its latest
+version.
diff --git a/changes/636.misc.rst b/changes/636.misc.rst
diff --git a/changes/637.misc.rst → changes/637.misc.md b/changes/637.misc.rst → changes/637.misc.md
diff --git a/changes/638.misc.rst → changes/638.misc.md b/changes/638.misc.rst → changes/638.misc.md
diff --git a/changes/639.misc.rst → changes/639.misc.md b/changes/639.misc.rst → changes/639.misc.md
@@ -1 +1,2 @@
-The pinned dependencies in pyproject.toml and tox.ini were updated to their latest versions.
+The pinned dependencies in pyproject.toml and tox.ini were updated to
+their latest versions.
diff --git a/changes/640.misc.md b/changes/640.misc.md
@@ -0,0 +1,2 @@
+The `pre-commit` hook for `ruff-pre-commit` was updated to its latest
+version.
diff --git a/changes/640.misc.rst b/changes/640.misc.rst
diff --git a/changes/641.misc.rst → changes/641.misc.md b/changes/641.misc.rst → changes/641.misc.md
diff --git a/changes/642.misc.rst → changes/642.misc.md b/changes/642.misc.rst → changes/642.misc.md
diff --git a/changes/643.misc.rst → changes/643.misc.md b/changes/643.misc.rst → changes/643.misc.md
diff --git a/changes/644.misc.rst → changes/644.misc.md b/changes/644.misc.rst → changes/644.misc.md
diff --git a/changes/645.misc.md b/changes/645.misc.md
@@ -0,0 +1,2 @@
+The `pre-commit` hook for `ruff-pre-commit` was updated to its latest
+version.
diff --git a/changes/645.misc.rst b/changes/645.misc.rst
diff --git a/changes/646.misc.rst → changes/646.misc.md b/changes/646.misc.rst → changes/646.misc.md
diff --git a/changes/647.misc.md b/changes/647.misc.md
@@ -0,0 +1,2 @@
+The `pre-commit` hook for `ruff-pre-commit` was updated to its latest
+version.
diff --git a/changes/647.misc.rst b/changes/647.misc.rst
diff --git a/changes/649.misc.md b/changes/649.misc.md
@@ -0,0 +1,2 @@
+The `pre-commit` hook for `ruff-pre-commit` was updated to its latest
+version.
diff --git a/changes/649.misc.rst b/changes/649.misc.rst
diff --git a/changes/650.misc.rst → changes/650.misc.md b/changes/650.misc.rst → changes/650.misc.md
diff --git a/changes/651.misc.rst → changes/651.misc.md b/changes/651.misc.rst → changes/651.misc.md
diff --git a/changes/652.misc.md b/changes/652.misc.md
@@ -0,0 +1,2 @@
+The `pre-commit` hook for `ruff-pre-commit` was updated to its latest
+version.
diff --git a/changes/652.misc.rst b/changes/652.misc.rst
diff --git a/changes/654.misc.rst → changes/654.misc.md b/changes/654.misc.rst → changes/654.misc.md
diff --git a/changes/655.misc.md b/changes/655.misc.md
@@ -0,0 +1,2 @@
+The `pre-commit` hook for `ruff-pre-commit` was updated to its latest
+version.
diff --git a/changes/655.misc.rst b/changes/655.misc.rst
diff --git a/changes/658.doc.md b/changes/658.doc.md
@@ -0,0 +1 @@
+Rubicon Obj-C's documentation was migrated to Markdown format.
diff --git a/changes/template.rst → changes/template.md b/changes/template.rst → changes/template.md
@@ -1,17 +1,16 @@
 {% for section, _ in sections.items() %}
-{% set underline = underlines[0] %}{% if section %}{{section}}
-{{ underline * section|length }}{% set underline = underlines[1] %}
+{% if section %}
+{{section}}
 
 {% endif %}
 
 {% if sections[section] %}
 {% for category, val in definitions.items() if category in sections[section]%}
-{{ definitions[category]['name'] }}
-{{ underline * definitions[category]['name']|length }}
+### {{ definitions[category]['name'] }}
 
 {% if definitions[category]['showcontent'] %}
 {% for text, values in sections[section][category].items() %}
-* {{ text }} ({{ values|join(', ') }})
+* {{ text }} ({{values|join(', ') }})
 {% endfor %}
 
 {% else %}

diff --git a/docs/Makefile b/docs/Makefile
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		The `pre-commit` hook for `pre-commit-hooks` was updated to its latest
		version.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		The `pre-commit` hook for `ruff-pre-commit` was updated to its latest
		version.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Rubicon Obj-C's documentation was migrated to Markdown format.