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: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
