Skip to content

docs: remove stale Java 8/11 framing now that JDK 17 is the minimum - #3487

Merged
pjfanning merged 1 commit into
apache:mainfrom
samueleresca:docs/fix-stale-jdk17-java8-refs
Aug 30, 2026
Merged

docs: remove stale Java 8/11 framing now that JDK 17 is the minimum#3487
pjfanning merged 1 commit into
apache:mainfrom
samueleresca:docs/fix-stale-jdk17-java8-refs

Conversation

@samueleresca

Copy link
Copy Markdown
Member

Pekko 2.0.x requires JDK 17 as the minimum supported runtime (see release-notes/releases-2.0.md and project/JdkOptions.scala).

Modification:

  • remoting-artery.md: reworded the Aeron --add-opens note and the Flight Recorder section, which claimed JFR is enabled by "detecting JDK 11" even though there is no such runtime detection in FlightRecorderLoader.scala - it is controlled purely by the pekko.java-flight-recorder.enabled config flag.
  • remote-security.md: dropped a TLS cipher caveat about Java 8 runtimes, which are no longer supported.
  • stream/reactive-streams-interop.md: removed Java-8-specific Reactive Streams artifact/JavaFlowSupport caveats.
  • persistence.md, typed/cluster-sharding.md, typed/distributed-data.md: reworded the LevelDB/LMDB --add-opens notes so they no longer frame JDK 17 as an optional/special case.
  • actor/src/main/resources/reference.conf: fixed the same stale "JDK 11 or later" framing in the java-flight-recorder comment, which is snip-included into docs/src/main/paradox/general/configuration-reference.md.

Result:
Doc pages and the flight-recorder config comment reflect the current JDK 17+ baseline instead of pre-2.0 Java 8/11 assumptions.

Motivation:
Pekko 2.0.x requires JDK 17 as the minimum supported runtime (see
release-notes/releases-2.0.md and project/JdkOptions.scala), a hard
break from the 1.x line which supported Java 8+. Several doc pages and
one reference.conf comment still carried Java 8/11-era framing that no
longer applies to the current major version.

Modification:
- remoting-artery.md: reworded the Aeron `--add-opens` note and the
  Flight Recorder section, which claimed JFR is enabled by "detecting
  JDK 11" even though there is no such runtime detection in
  FlightRecorderLoader.scala - it is controlled purely by the
  `pekko.java-flight-recorder.enabled` config flag.
- remote-security.md: dropped a TLS cipher caveat about Java 8
  runtimes, which are no longer supported.
- stream/reactive-streams-interop.md: removed Java-8-specific
  Reactive Streams artifact/JavaFlowSupport caveats.
- persistence.md, typed/cluster-sharding.md,
  typed/distributed-data.md: reworded the LevelDB/LMDB `--add-opens`
  notes so they no longer frame JDK 17 as an optional/special case.
- actor/src/main/resources/reference.conf: fixed the same stale "JDK
  11 or later" framing in the java-flight-recorder comment, which is
  snip-included into
  docs/src/main/paradox/general/configuration-reference.md.

Result:
Doc pages and the flight-recorder config comment reflect the current
JDK 17+ baseline instead of pre-2.0 Java 8/11 assumptions.

Tests:
- Not run - docs and comment-only changes.

References:
None - identified while auditing docs/src/main/paradox for content
out of date relative to the current Pekko version and JDK support.

@pjfanning pjfanning left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

lgtm

@pjfanning
pjfanning merged commit 80477d3 into apache:main Aug 30, 2026
15 of 16 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