Skip to content

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

Open
andygrove wants to merge 1 commit into
apache:mainfrom
andygrove:tiny-fossil
Open

docs: correct Spark 4.2 version and CI test status in installation guide#5315
andygrove wants to merge 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.
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.

1 participant