Upgrade documentation environments to Sphinx 9

[aryanputta]

Summary

• Upgrade the three component Pixi documentation environments to Sphinx 9.x.
• Update the shared conda docs environment and setup script.
• Keep all documentation dependency sources consistent.

Motivation

Closes #2598. The repository currently constrains Sphinx to <8.2.0, which prevents keeping the documentation toolchain current and can cause documented Sphinx directive syntax to drift from the installed version.

This is separate from #2584, which fixes documentation defects rather than the dependency upgrade.

Validation

• TOML and shared-environment consistency check
• bash -n toolshed/setup-docs-env.sh
• git diff --check

Pixi is not installed in the local environment, so the component documentation builds could not be run locally. CI should validate Sphinx 9.x compatibility across the documentation builds.

[copy-pr-bot]

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

[aryanputta]

@mdboom I opened this draft PR for #2598. It updates the shared CI documentation environment from Sphinx <8.2.0 to Sphinx 9.x, along with the three component Pixi manifests and the local setup script. The local syntax and consistency checks pass; the full docs build is intended to run in CI because Pixi is not installed locally. Please let me know if you would like any changes, or if the team would prefer to handle this upgrade internally. Thanks!

[mdboom]

/ok to test 53b0e5e

[aryanputta]

I pushed a follow-up fix to the PR branch. The Sphinx 9 upgrade was leaving sphinx-toolbox on the conda-forge 4.1.2 line, which is incompatible with Sphinx 9. The docs environments now install sphinx-toolbox>=4.2.0 from PyPI consistently across Pixi, the shared conda environment, and the setup script. Local TOML/YAML parsing, shell syntax, and git diff --check pass. Could you please rerun CI when convenient?

[mdboom]

/ok to test 5e75843