CynicDog opened a new pull request, #57199: URL: https://github.com/apache/spark/pull/57199
### What changes were proposed in this pull request? Adds an `Examples` section to `Column.outer()`'s docstring in `python/pyspark/sql/column.py`. Every other `Column` method in this file has a worked example; `outer()` was the one exception. The example builds a small `employees` DataFrame and uses `.outer()` inside a correlated scalar subquery to filter employees earning above their department's average salary. ### Why are the changes needed? `outer()` is easy to misunderstand from the description alone, since its effect (marking a column so it resolves against an outer query) only makes sense in the context of a correlated subquery. A concrete example makes that immediately clear, consistent with the rest of the file. ### Does this PR introduce _any_ user-facing change? No. Documentation-only change (a docstring example). ### How was this patch tested? Built Spark locally (`build/sbt -Phive package`) and ran the `Column.outer` doctest directly against the built jars to confirm the example's output matches exactly. ### Was this patch authored or co-authored using generative AI tooling? <!-- TODO: fill in before submitting --> -- 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]
