Repository navigation
docs: [branch-1.2] generate docs for the 1.2.0 release - #7292
Merged
Merged
Conversation
mbutrovich
approved these changes
Oct 28, 2026
mbutrovich
left a comment
Contributor
There was a problem hiding this comment.
Reviewed the mechanism mostly, not the actual product too closely. Thanks @andygrove!
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Which issue does this PR close?
Part of #6550. This is the "Generate release documentation" step of the release process.
Rationale for this change
On
main,docs/source/user-guide/latest/holds template markers and CI fills them at publish time. A release branch commits the generated content, so the archived docs for 1.2.0 render real tables.What changes are included in this PR?
The output of
./dev/generate-release-docs.shonbranch-1.2at286be994d2(after #7290), with no hand edits except the prettier fix below:configs.md: the generated config tables for all ten categories.expressions.md: the Implementation column, refreshed from the serde registered on this branch. The 18 changed lines bring it in line with the code. The values follow the same pattern as the 1.1.0 release docs, for examplemodeandhourare—,<<isNativeandcastisHybrid.compatibility/expressions/spark-3.4,spark-3.5,spark-4.0,spark-4.1andspark-4.2: the per-Spark-version compatibility pages, 10 files each. 1.1.0 had four of these directories, and 4.2 is new.The script ran one Maven build per profile, and all five succeeded. A second commit adds one blank line before
<!--END:EXPR_COMPAT-->in 40 of the generated pages. The script formats with whichever prettiernpxfinds locally, and the CI check installs the latest prettier, which wants that blank line. Prettier 3.9.10 passes ondocs/source/user-guide/latest/with both commits.How are these changes tested?
The files are generated, so there is nothing to run beyond the script itself. I did not read through the generated tables line by line.
#7291 adds one entry to the changelog and doesn't touch these files, so merge order doesn't matter. Anything else that changes a config's description or default, or the supported expressions, needs these docs regenerated.