Skip to content

docs: create sphinx extension to format schemas nicely

4c60f93
Select commit
Loading
Failed to load commit list.
Merged

Improve schema handling in documentation #705

docs: create sphinx extension to format schemas nicely
4c60f93
Select commit
Loading
Failed to load commit list.
firefoxci-taskcluster / doc-generate succeeded Jun 17, 2025 in 2m 35s

FirefoxCI (pull_request)

Generate documentation and fail on warnings (Treeherder push)

Details

View task in Taskcluster | View logs in Taskcluster | View task group in Taskcluster

Task Status

Started: 2025-06-17T13:41:52.379Z
Resolved: 2025-06-17T13:42:40.670Z
Task Execution Time: 48 seconds, 291 milliseconds
Task Status: completed
Reason Resolved: completed
RunId: 0

Artifacts

- public/logs/live_backing.log
- public/logs/live.log


[taskcluster 2025-06-17 13:41:52.518Z] Task ID: R_R8_wbeTw-1S85GA-oMsA
[taskcluster 2025-06-17 13:41:52.518Z] Worker ID: 4676618973460876967
[taskcluster 2025-06-17 13:41:52.518Z] Worker Group: us-central1-c
[taskcluster 2025-06-17 13:41:52.518Z] Worker Node Type: projects/887720501152/machineTypes/c2-standard-4
[taskcluster 2025-06-17 13:41:52.518Z] Worker Pool: taskgraph-t/linux-gcp
[taskcluster 2025-06-17 13:41:52.518Z] Worker Version: 38.0.5
[taskcluster 2025-06-17 13:41:52.518Z] Public IP: 34.27.35.25
[taskcluster 2025-06-17 13:41:52.518Z] Hostname: taskgraph-t-linux-gcp-dzzszhttr8ifv67l6yyl1g
[taskcluster 2025-06-17 13:41:52.518Z] using cache "taskgraph-level-1-uv-v3-581ca6876fac84fa2dd8-UZjHBI2tQfq89wKjHYVaYA" -> /builds/worker/.task-cache/uv
[taskcluster 2025-06-17 13:41:52.518Z] using cache "taskgraph-level-1-checkouts-v3-581ca6876fac84fa2dd8-UZjHBI2tQfq89wKjHYVaYA" -> /builds/worker/checkouts

[taskcluster 2025-06-17 13:41:55.835Z] Downloading artifact "public/image.tar.zst" from task ID: UZjHBI2tQfq89wKjHYVaYA.
[taskcluster 2025-06-17 13:41:59.922Z] Downloaded artifact successfully.
[taskcluster 2025-06-17 13:41:59.924Z] Downloaded 255.331 mb
[taskcluster 2025-06-17 13:41:59.925Z] Decompressing downloaded image
[taskcluster 2025-06-17 13:42:01.933Z] Loading docker image from downloaded archive.
[taskcluster 2025-06-17 13:42:22.063Z] Image 'public/image.tar.zst' from task 'UZjHBI2tQfq89wKjHYVaYA' loaded.  Using image ID sha256:33b5627438f7fa0c24087c8f98108b88769afc6b0607a026797dd6b4a3f3b188.
[taskcluster 2025-06-17 13:42:22.213Z] === Task Starting ===
[setup 2025-06-17T13:42:24.303+00:00] run-task started in /
[setup 2025-06-17T13:42:24.303+00:00] Invoked by command: --ci-checkout=/builds/worker/checkouts/vcs/ --task-cwd /builds/worker/checkouts/vcs -- bash -cx uv run make html
[setup 2025-06-17T13:42:24.303+00:00] Python version: 3.11.2
[cache 2025-06-17T13:42:24.305+00:00] cache /builds/worker/.task-cache/uv is empty; writing requirements: gid=1000 uid=1000 version=1
[cache 2025-06-17T13:42:24.305+00:00] cache /builds/worker/checkouts is empty; writing requirements: gid=1000 uid=1000 version=1
[volume 2025-06-17T13:42:24.306+00:00] volume /builds/worker/.task-cache/uv is a cache
[volume 2025-06-17T13:42:24.306+00:00] volume /builds/worker/checkouts is a cache
[setup 2025-06-17T13:42:24.306+00:00] running as worker:worker
[vcs 2025-06-17T13:42:24.306+00:00] executing ['git', 'config', '--global', '--add', 'safe.directory', '/builds/worker/checkouts/vcs']
[vcs 2025-06-17T13:42:24.308+00:00] executing ['git', 'clone', 'https://github.com/taskcluster/taskgraph', '/builds/worker/checkouts/vcs']
[vcs 2025-06-17T13:42:24.310+00:00] Cloning into '/builds/worker/checkouts/vcs'...
[vcs 2025-06-17T13:42:25.153+00:00] executing ['git', 'fetch', '--no-tags', 'https://github.com/ahal/taskgraph', 'ahal/push-xtusqkostmqv']
[vcs 2025-06-17T13:42:25.412+00:00] From https://github.com/ahal/taskgraph
[vcs 2025-06-17T13:42:25.412+00:00]  * branch              ahal/push-xtusqkostmqv -> FETCH_HEAD
[vcs 2025-06-17T13:42:25.414+00:00] executing ['git', 'checkout', '-f', '-B', 'ahal/push-xtusqkostmqv', '4c60f934133e412c9ddceac67d3023fdbc819b51']
[vcs 2025-06-17T13:42:25.431+00:00] Switched to a new branch 'ahal/push-xtusqkostmqv'
[vcs 2025-06-17T13:42:25.431+00:00] cleaning git checkout...
[vcs 2025-06-17T13:42:25.431+00:00] executing ['git', 'clean', '-nxdff']
[vcs 2025-06-17T13:42:25.433+00:00] removing []
[vcs 2025-06-17T13:42:25.434+00:00] successfully cleaned git checkout!
[vcs 2025-06-17T13:42:25.435+00:00] TinderboxPrint:<a href='https://github.com/ahal/taskgraph/commit/4c60f934133e412c9ddceac67d3023fdbc819b51' title='Built from taskgraph commit 4c60f934133e412c9ddceac67d3023fdbc819b51'>4c60f934133e412c9ddceac67d3023fdbc819b51</a>
[task 2025-06-17T13:42:25.435+00:00] executing ['bash', '-cx', 'uv run make html']
[task 2025-06-17T13:42:25.436+00:00] + uv run make html
[task 2025-06-17T13:42:25.607+00:00] Using CPython 3.13.2
[task 2025-06-17T13:42:25.607+00:00] Creating virtual environment at: .venv
[task 2025-06-17T13:42:25.633+00:00]    Building taskcluster-taskgraph @ file:///builds/worker/checkouts/vcs
[task 2025-06-17T13:42:25.633+00:00]    Building pytest-taskgraph @ file:///builds/worker/checkouts/vcs/packages/pytest-taskgraph
[task 2025-06-17T13:42:25.633+00:00]    Building sphinx-taskgraph @ file:///builds/worker/checkouts/vcs/packages/sphinx-taskgraph
[task 2025-06-17T13:42:25.692+00:00] Downloading pygments (1.2MiB)
[task 2025-06-17T13:42:25.692+00:00] Downloading zstandard (5.2MiB)
[task 2025-06-17T13:42:25.693+00:00] Downloading accessible-pygments (1.3MiB)
[task 2025-06-17T13:42:25.693+00:00] Downloading virtualenv (5.8MiB)
[task 2025-06-17T13:42:25.694+00:00] Downloading pyright (5.4MiB)
[task 2025-06-17T13:42:25.694+00:00] Downloading babel (9.7MiB)
[task 2025-06-17T13:42:25.694+00:00] Downloading sphinx (3.4MiB)
[task 2025-06-17T13:42:25.694+00:00] Downloading pydata-sphinx-theme (4.4MiB)
[task 2025-06-17T13:42:26.226+00:00]  Downloaded accessible-pygments
[task 2025-06-17T13:42:26.398+00:00]  Downloaded pygments
[task 2025-06-17T13:42:26.451+00:00]  Downloaded pydata-sphinx-theme
[task 2025-06-17T13:42:26.503+00:00]  Downloaded zstandard
[task 2025-06-17T13:42:26.535+00:00]  Downloaded virtualenv
[task 2025-06-17T13:42:26.620+00:00]  Downloaded sphinx
[task 2025-06-17T13:42:26.770+00:00]  Downloaded babel
[task 2025-06-17T13:42:27.160+00:00]  Downloaded pyright
[task 2025-06-17T13:42:27.292+00:00]       Built taskcluster-taskgraph @ file:///builds/worker/checkouts/vcs
[task 2025-06-17T13:42:27.335+00:00]       Built sphinx-taskgraph @ file:///builds/worker/checkouts/vcs/packages/sphinx-taskgraph
[task 2025-06-17T13:42:27.425+00:00]       Built pytest-taskgraph @ file:///builds/worker/checkouts/vcs/packages/pytest-taskgraph
[task 2025-06-17T13:42:27.427+00:00] warning: Failed to hardlink files; falling back to full copy. This may lead to degraded performance.
[task 2025-06-17T13:42:27.427+00:00]          If the cache and target directories are on different filesystems, hardlinking may not be supported.
[task 2025-06-17T13:42:27.427+00:00]          If this is intentional, set `export UV_LINK_MODE=copy` or use `--link-mode=copy` to suppress this warning.
[task 2025-06-17T13:42:27.673+00:00] Installed 81 packages in 246ms
[task 2025-06-17T13:42:28.612+00:00] Running Sphinx v8.2.3
[task 2025-06-17T13:42:28.613+00:00] loading translations [en]... done
[task 2025-06-17T13:42:29.913+00:00] making output directory... done
[task 2025-06-17T13:42:30.113+00:00] building [mo]: targets for 0 po files that are out of date
[task 2025-06-17T13:42:30.113+00:00] writing output... 
[task 2025-06-17T13:42:30.117+00:00] building [html]: targets for 43 source files that are out of date
[task 2025-06-17T13:42:30.120+00:00] updating environment: [new config] 43 added, 0 changed, 0 removed
[task 2025-06-17T13:42:30.120+00:00] reading sources... [  2%] concepts/index
[task 2025-06-17T13:42:30.140+00:00] reading sources... [  5%] concepts/kind
[task 2025-06-17T13:42:30.145+00:00] reading sources... [  7%] concepts/loading
[task 2025-06-17T13:42:30.152+00:00] reading sources... [  9%] concepts/optimization
[task 2025-06-17T13:42:30.162+00:00] reading sources... [ 12%] concepts/scopes
[task 2025-06-17T13:42:30.186+00:00] reading sources... [ 14%] concepts/task-graphs
[task 2025-06-17T13:42:30.205+00:00] reading sources... [ 16%] concepts/taskcluster
[task 2025-06-17T13:42:30.210+00:00] reading sources... [ 19%] concepts/transforms
[task 2025-06-17T13:42:30.226+00:00] reading sources... [ 21%] contributing
[task 2025-06-17T13:42:30.250+00:00] reading sources... [ 23%] glossary
[task 2025-06-17T13:42:30.279+00:00] reading sources... [ 26%] howto/bootstrap-taskgraph
[task 2025-06-17T13:42:30.302+00:00] reading sources... [ 28%] howto/create-actions
[task 2025-06-17T13:42:30.330+00:00] reading sources... [ 30%] howto/create-tasks
[task 2025-06-17T13:42:30.342+00:00] reading sources... [ 33%] howto/debugging
[task 2025-06-17T13:42:30.349+00:00] reading sources... [ 35%] howto/docker
[task 2025-06-17T13:42:30.374+00:00] reading sources... [ 37%] howto/index
[task 2025-06-17T13:42:30.377+00:00] reading sources... [ 40%] howto/resolve-keyed-by
[task 2025-06-17T13:42:30.391+00:00] reading sources... [ 42%] howto/run-locally
[task 2025-06-17T13:42:30.416+00:00] reading sources... [ 44%] howto/send-notifications
[task 2025-06-17T13:42:30.436+00:00] reading sources... [ 47%] howto/use-fetches
[task 2025-06-17T13:42:30.447+00:00] reading sources... [ 49%] index
[task 2025-06-17T13:42:30.467+00:00] reading sources... [ 51%] reference/cli
[task 2025-06-17T13:42:30.694+00:00] reading sources... [ 53%] reference/index
[task 2025-06-17T13:42:30.697+00:00] reading sources... [ 56%] reference/migrations
[task 2025-06-17T13:42:30.729+00:00] reading sources... [ 58%] reference/optimization-strategies
[task 2025-06-17T13:42:30.738+00:00] reading sources... [ 60%] reference/parameters
[task 2025-06-17T13:42:30.758+00:00] reading sources... [ 63%] reference/source/modules
[task 2025-06-17T13:42:30.761+00:00] reading sources... [ 65%] reference/source/taskgraph
[task 2025-06-17T13:42:31.583+00:00] reading sources... [ 67%] reference/source/taskgraph.actions
[task 2025-06-17T13:42:31.760+00:00] reading sources... [ 70%] reference/source/taskgraph.loader
[task 2025-06-17T13:42:31.776+00:00] reading sources... [ 72%] reference/source/taskgraph.optimize
[task 2025-06-17T13:42:31.900+00:00] reading sources... [ 74%] reference/source/taskgraph.transforms
[task 2025-06-17T13:42:32.416+00:00] reading sources... [ 77%] reference/source/taskgraph.transforms.run
[task 2025-06-17T13:42:32.587+00:00] reading sources... [ 79%] reference/source/taskgraph.util
[task 2025-06-17T13:42:33.677+00:00] reading sources... [ 81%] reference/transforms/chunking
[task 2025-06-17T13:42:33.685+00:00] reading sources... [ 84%] reference/transforms/from_deps
[task 2025-06-17T13:42:33.711+00:00] reading sources... [ 86%] reference/transforms/index
[task 2025-06-17T13:42:33.714+00:00] reading sources... [ 88%] reference/transforms/matrix
[task 2025-06-17T13:42:33.730+00:00] reading sources... [ 91%] reference/transforms/task_context
[task 2025-06-17T13:42:33.742+00:00] reading sources... [ 93%] tutorials/connecting-taskcluster
[task 2025-06-17T13:42:33.772+00:00] reading sources... [ 95%] tutorials/creating-a-task-graph
[task 2025-06-17T13:42:33.790+00:00] reading sources... [ 98%] tutorials/getting-started
[task 2025-06-17T13:42:33.805+00:00] reading sources... [100%] tutorials/index
[task 2025-06-17T13:42:33.808+00:00] 
[task 2025-06-17T13:42:33.808+00:00] looking for now-outdated files... none found
[task 2025-06-17T13:42:33.824+00:00] pickling environment... done
[task 2025-06-17T13:42:33.824+00:00] checking consistency... done
[task 2025-06-17T13:42:33.826+00:00] preparing documents... done
[task 2025-06-17T13:42:33.826+00:00] copying assets... 
[task 2025-06-17T13:42:33.827+00:00] copying downloadable files... [100%] tutorials/example-taskcluster.yml
[task 2025-06-17T13:42:33.827+00:00] 
[task 2025-06-17T13:42:33.827+00:00] copying static files... 
[task 2025-06-17T13:42:33.832+00:00] Writing evaluated template result to /builds/worker/checkouts/vcs/docs/_build/html/_static/language_data.js
[task 2025-06-17T13:42:33.835+00:00] Writing evaluated template result to /builds/worker/checkouts/vcs/docs/_build/html/_static/documentation_options.js
[task 2025-06-17T13:42:33.839+00:00] Writing evaluated template result to /builds/worker/checkouts/vcs/docs/_build/html/_static/basic.css
[task 2025-06-17T13:42:33.868+00:00] copying static files: done
[task 2025-06-17T13:42:33.868+00:00] copying extra files... 
[task 2025-06-17T13:42:33.868+00:00] copying extra files: done
[task 2025-06-17T13:42:33.868+00:00] copying assets: done
[task 2025-06-17T13:42:33.869+00:00] writing output... [  2%] concepts/index
[task 2025-06-17T13:42:34.033+00:00] writing output... [  5%] concepts/kind
[task 2025-06-17T13:42:34.085+00:00] writing output... [  7%] concepts/loading
[task 2025-06-17T13:42:34.161+00:00] writing output... [  9%] concepts/optimization
[task 2025-06-17T13:42:34.217+00:00] writing output... [ 12%] concepts/scopes
[task 2025-06-17T13:42:34.278+00:00] writing output... [ 14%] concepts/task-graphs
[task 2025-06-17T13:42:34.475+00:00] writing output... [ 16%] concepts/taskcluster
[task 2025-06-17T13:42:34.519+00:00] writing output... [ 19%] concepts/transforms
[task 2025-06-17T13:42:34.581+00:00] writing output... [ 21%] contributing
[task 2025-06-17T13:42:34.648+00:00] writing output... [ 23%] glossary
[task 2025-06-17T13:42:34.697+00:00] writing output... [ 26%] howto/bootstrap-taskgraph
[task 2025-06-17T13:42:34.761+00:00] writing output... [ 28%] howto/create-actions
[task 2025-06-17T13:42:34.842+00:00] writing output... [ 30%] howto/create-tasks
[task 2025-06-17T13:42:34.899+00:00] writing output... [ 33%] howto/debugging
[task 2025-06-17T13:42:34.954+00:00] writing output... [ 35%] howto/docker
[task 2025-06-17T13:42:35.028+00:00] writing output... [ 37%] howto/index
[task 2025-06-17T13:42:35.205+00:00] writing output... [ 40%] howto/resolve-keyed-by
[task 2025-06-17T13:42:35.273+00:00] writing output... [ 42%] howto/run-locally
[task 2025-06-17T13:42:35.341+00:00] writing output... [ 44%] howto/send-notifications
[task 2025-06-17T13:42:35.407+00:00] writing output... [ 47%] howto/use-fetches
[task 2025-06-17T13:42:35.459+00:00] writing output... [ 49%] index
[task 2025-06-17T13:42:35.542+00:00] writing output... [ 51%] reference/cli
[task 2025-06-17T13:42:35.652+00:00] writing output... [ 53%] reference/index
[task 2025-06-17T13:42:35.854+00:00] writing output... [ 56%] reference/migrations
[task 2025-06-17T13:42:35.927+00:00] writing output... [ 58%] reference/optimization-strategies
[task 2025-06-17T13:42:35.977+00:00] writing output... [ 60%] reference/parameters
[task 2025-06-17T13:42:36.045+00:00] writing output... [ 63%] reference/source/modules
[task 2025-06-17T13:42:36.124+00:00] writing output... [ 65%] reference/source/taskgraph
[task 2025-06-17T13:42:36.533+00:00] writing output... [ 67%] reference/source/taskgraph.actions
[task 2025-06-17T13:42:36.634+00:00] writing output... [ 70%] reference/source/taskgraph.loader
[task 2025-06-17T13:42:36.680+00:00] writing output... [ 72%] reference/source/taskgraph.optimize
[task 2025-06-17T13:42:36.764+00:00] writing output... [ 74%] reference/source/taskgraph.transforms
[task 2025-06-17T13:42:36.919+00:00] writing output... [ 77%] reference/source/taskgraph.transforms.run
[task 2025-06-17T13:42:37.015+00:00] writing output... [ 79%] reference/source/taskgraph.util
[task 2025-06-17T13:42:37.335+00:00] writing output... [ 81%] reference/transforms/chunking
[task 2025-06-17T13:42:37.553+00:00] writing output... [ 84%] reference/transforms/from_deps
[task 2025-06-17T13:42:37.629+00:00] writing output... [ 86%] reference/transforms/index
[task 2025-06-17T13:42:37.676+00:00] writing output... [ 88%] reference/transforms/matrix
[task 2025-06-17T13:42:37.738+00:00] writing output... [ 91%] reference/transforms/task_context
[task 2025-06-17T13:42:37.801+00:00] writing output... [ 93%] tutorials/connecting-taskcluster
[task 2025-06-17T13:42:37.876+00:00] writing output... [ 95%] tutorials/creating-a-task-graph
[task 2025-06-17T13:42:37.944+00:00] writing output... [ 98%] tutorials/getting-started
[task 2025-06-17T13:42:37.996+00:00] writing output... [100%] tutorials/index
[task 2025-06-17T13:42:38.038+00:00] 
[task 2025-06-17T13:42:38.287+00:00] generating indices... genindex py-modindex done
[task 2025-06-17T13:42:38.334+00:00] writing additional pages... search done
[task 2025-06-17T13:42:38.347+00:00] dumping search index in English (code: en)... done
[task 2025-06-17T13:42:38.353+00:00] dumping object inventory... done
[task 2025-06-17T13:42:38.388+00:00] build succeeded.
[task 2025-06-17T13:42:38.388+00:00] 
[task 2025-06-17T13:42:38.389+00:00] The HTML pages are in docs/_build/html.
[taskcluster 2025-06-17 13:42:40.012Z] === Task Finished ===
[taskcluster 2025-06-17 13:42:40.012Z] Successful task run with exit code: 0 completed in 47.495 seconds