run test and docs CI on 3.14 (#595)

Update to support 3.14

* run tests and docs CI on 3.14
* Minimial changes to pinnings that require minimal code/markup changes

Author: molpopgen

.github/workflows/docs.yaml

@@ -20,7 +20,7 @@ jobs:
           fetch-depth: 0
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.12"
+          python-version: "3.14"
 
       - name: Install the latest version of uv
         uses: astral-sh/setup-uv@v7

.github/workflows/tests.yaml

@@ -25,7 +25,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-24.04, windows-2022, macos-14]
-        python-version: ["3.12"]
+        python-version: ["3.12", "3.14"]
     env:
       OS: ${{ matrix.os }}
       PYTHON: ${{ matrix.python-version }}

docs/introduction.md

@@ -23,8 +23,8 @@ set_matplotlib_formats("svg")
 # Introduction
 
 The `demes` Python package provides an API for defining, parsing, and sharing
-[Demes](spec:sec_intro) demographic models. Applications can use
-`demes` to parse human-readable [Demes YAML files](spec:sec_tutorial)
+[Demes](sec_intro) demographic models. Applications can use
+`demes` to parse human-readable [Demes YAML files](sec_tutorial)
 into fully-resolved demographic models. In addition, `demes` provides
 convenient data structures to simplify manipulation of demographic models.
 If you find an error in the documentation or a bug in the software,
@@ -43,7 +43,7 @@ simulation software has its own syntax and style for defining the demography.
 Learning curves for new software can be steep and mistakes are easy to make,
 especially for complex demographic scenarios.
 
-The [Demes Specification](spec:sec_intro) aims to make defining demographic
+The [Demes Specification](sec_intro) aims to make defining demographic
 models more intuitive, less prone to error or ambiguity, and readily
 interchangeable between simulation platforms.
 Demographic models, which define populations (or _demes_), their properties,
@@ -54,7 +54,7 @@ and relationships between them, are by convention written as a
 
 The following YAML file implements a two-epoch demographic
 history for a single deme, where the deme doubles in size 100 generations ago.
-See the [Demes tutorial](spec:sec_tutorial) for a detailed introduction to
+See the [Demes tutorial](sec_tutorial) for a detailed introduction to
 writing Demes YAML files.
 
 ```{literalinclude} ../examples/two_epoch.yaml

pyproject.toml

@@ -54,14 +54,13 @@ lint = [
 
 docs = [
     "demesdraw",
-    "jupyter-book==0.15.1",
+    "jupyter-book<2",
     "piccolo_theme",
     "sphinx_issues",
     "sphinxcontrib-programoutput",
-# Below here are hacks to make the docs
-# build until we can deal w/updating
-# jupyter-book
-    "ipython==8.29.0"
+# WARNING: ipython 9 removes functions
+# that the docs here and in demes-spec use
+    "ipython<9"
 ]
 
 [tool.setuptools_scm]