zhengruifeng opened a new pull request, #56142: URL: https://github.com/apache/spark/pull/56142
### What changes were proposed in this pull request? Fix all single-colon `.. versionadded:` typos in PySpark docstrings. The Sphinx directive is `.. versionadded::` (two colons); the single-colon form does not render as a directive — Sphinx treats the line as a definition list / orphan comment, so the "New in version X.Y.Z" notice silently disappears from the rendered API reference page. All 32 occurrences are corrected by adding the missing second colon. Version numbers themselves are unchanged. | File | Count | |---|---| | `python/pyspark/sql/connect/datasource.py` | 1 | | `python/pyspark/sql/dataframe.py` | 4 | | `python/pyspark/sql/datasource.py` | 14 | | `python/pyspark/sql/functions/builtin.py` | 1 | | `python/pyspark/sql/merge.py` | 1 | | `python/pyspark/sql/readwriter.py` | 11 | | **Total** | **32** | ### Why are the changes needed? The "New in version ..." notice currently fails to render on 32 API reference pages because of the typo. Users reading the rendered docs cannot tell when each affected method/class was introduced. ### Does this PR introduce _any_ user-facing change? Documentation-only change. After the fix, the affected API reference pages will display the "New in version ..." notice as intended. ### How was this patch tested? Doc-only change. Verified `grep -rn '\.\. versionadded: [0-9]' python/pyspark --include='*.py'` returns no matches after the fix, and that no `versionchanged:` (sibling directive) typos exist. ### Was this patch authored or co-authored using generative AI tooling? Generated-by: Claude Code (model: claude-opus-4-7) -- 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]
