You are viewing a plain text version of this content. The canonical link for it is here.
Posted to reviews@spark.apache.org by "marcuslin123 (via GitHub)" <gi...@apache.org> on 2026/07/03 15:36:23 UTC
[PR] [SPARK-57911][DOCS] Upgrade Sphinx version to 8.2.3 [spark]
marcuslin123 opened a new pull request, #56993:
URL: https://github.com/apache/spark/pull/56993
### What changes were proposed in this pull request?
Upgrade Sphinx from 4.5.0 to 8.2.3 for PySpark documentation generation:
- Bump `sphinx==4.5.0` to `sphinx==8.2.3` in `dev/requirements.txt`
- Remove `sphinxcontrib-*` upper bound pins that were only needed for Sphinx 4.x
- Update `master_doc` to `root_doc` in `conf.py` (renamed in Sphinx 4+)
- Update `needs_sphinx` from `'1.2'` to `'8.2'`
### Why are the changes needed?
Sphinx 4.5.0 is from 2022 and is significantly outdated. Upgrading to 8.2.3 provides faster builds, better error messages, modern Python support, and compatibility with newer Sphinx extensions and themes. The `sphinxcontrib-*` upper bounds were a workaround for Sphinx 4.x compatibility and are no longer needed.
### Does this PR introduce _any_ user-facing change?
No. Build tooling change only — does not affect generated documentation content or Spark runtime behavior.
### How was this patch tested?
- Verified Sphinx 8.2.3 loads correctly and `conf.py` compiles without errors
- Confirmed `root_doc` and `needs_sphinx` are valid configuration for Sphinx 8.x
- Full documentation build to be verified in CI (requires complete environment with pandoc, pyarrow, etc.)
### Was this patch authored or co-authored using generative AI tooling?
Generative AI tooling (Claude Code) was used as an assistive tool for implementation guidance.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: reviews-unsubscribe@spark.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: reviews-unsubscribe@spark.apache.org
For additional commands, e-mail: reviews-help@spark.apache.org
Re: [PR] [SPARK-57911][DOCS] Upgrade Sphinx version to 8.2.3 [spark]
Posted by "gaogaotiantian (via GitHub)" <gi...@apache.org>.
gaogaotiantian closed pull request #56993: [SPARK-57911][DOCS] Upgrade Sphinx version to 8.2.3
URL: https://github.com/apache/spark/pull/56993
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: reviews-unsubscribe@spark.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: reviews-unsubscribe@spark.apache.org
For additional commands, e-mail: reviews-help@spark.apache.org