Skip to content

docs: correct Spark 4.2 version and CI test status in installation guide - #5315

Merged
mbutrovich merged 1 commit into
apache:mainfrom
andygrove:tiny-fossil
Aug 10, 2026
Merged

docs: correct Spark 4.2 version and CI test status in installation guide#5315
mbutrovich merged 1 commit into
apache:mainfrom
andygrove:tiny-fossil

Conversation

@andygrove

Copy link
Copy Markdown
Member

Which issue does this PR close?

N/A — docs correction spotted while reading the installation guide.

Rationale for this change

The experimental-versions table in the installation guide has two stale claims about Spark 4.2:

  1. It lists the version as 4.2.0-preview4, but the spark-4.2 Maven profile in pom.xml targets the 4.2.0 final release (<spark.version>4.2.0</spark.version>).
  2. It says "Comet Tests in CI: No", but .github/workflows/pr_build_linux.yml has a "Spark 4.2, JDK 17" entry in the linux-test matrix, so Comet tests do run for 4.2.

What changes are included in this PR?

  • installation.md: experimental table row becomes 4.2.0 with "Comet Tests in CI: Yes".
  • compatibility/spark-versions.md: drop the -preview4 suffix and reword the warning, which claimed 4.2 support "targets a preview release of Spark".
  • adding_a_new_spark_version.md: the two 4.2.0-preview4 examples cited a version Comet no longer targets; switched to a hypothetical future release so they keep illustrating the release-qualifier point.

Spark SQL tests still do not run for 4.2 — there is no spark_4_2 job in ci.yml — so that column stays "No" and 4.2 remains in the experimental tier. Per the promotion criteria in adding_a_new_spark_version.md, promotion to "Supported" requires both CI columns to be "Yes", so this PR intentionally does not promote it.

How are these changes tested?

Docs only. npx prettier reports no changes for all three files.

The installation guide listed the experimental Spark 4.2 support as
targeting `4.2.0-preview4` and claimed no Comet tests run in CI. Both
are stale:

- The `spark-4.2` Maven profile targets the `4.2.0` final release.
- `pr_build_linux.yml` includes a "Spark 4.2, JDK 17" job in the
  `linux-test` matrix, so Comet tests do run in CI.

Spark SQL tests still do not run for 4.2 (no `spark_4_2` job in
`ci.yml`), so that column stays "No" and the version remains
experimental.

Also refresh the two `4.2.0-preview4` examples in the contributor guide,
which cited a version Comet no longer targets, to use a hypothetical
future release instead.

@mbutrovich mbutrovich left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @andygrove!

@mbutrovich
mbutrovich merged commit bdd2aeb into apache:main Aug 10, 2026
17 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants