alamb opened a new pull request, #27138: URL: https://github.com/apache/datafusion/pull/27138
## Which issue does this PR close? - N/A (documentation only) ## Rationale for this change The doc comments on `JoinType` are terse and inconsistent. Several variants are a single line, and none show what the join actually produces. A short summary plus a small worked example for each variant makes the semantics clear at a glance, especially for the less common Semi / Anti / Mark variants. ## What changes are included in this PR? - Add a shared pair of example input tables to the `JoinType` enum docs, joined on `left.id = right.id`. The inputs include an unmatched row on each side and a duplicate key on the right so every variant's behavior is visible. - Rewrite the docs for `Inner` and `Left` with a brief summary followed by the output table for those inputs. This PR currently covers only the first two variants so the format can be reviewed. The remaining variants will follow the same pattern. ## What is the testing strategy for this PR? Documentation only. Verified with `cargo doc -p datafusion-common` under `RUSTDOCFLAGS="-D warnings"` (checks the intra-doc links), plus `cargo fmt` and `cargo clippy`. ## Are there any user-facing changes? Rust API documentation only. No behavior change. -- 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]
