Skip to content

Commit 8b36584

Browse files
authored
Merge pull request #2351 from SethTisue/jdk8-is-dying
2 parents 1b39461 + aa00e9c commit 8b36584

File tree

1 file changed

+4
-6
lines changed

1 file changed

+4
-6
lines changed

_overviews/jdk-compatibility/overview.md

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -26,13 +26,11 @@ Lightbend offers [commercial support](https://www.lightbend.com/lightbend-platfo
2626

2727
## Running versus compiling
2828

29-
JDK 8, 11, and 17 are all good choices both for *compiling* and *running* Scala code.
29+
JDK 8, 11, and 17 are all reasonable choices both for *compiling* and *running* Scala code.
3030

3131
Since the JVM is normally backwards compatible, it is usually safe to use a newer JVM for *running* your code than the one it was compiled on, especially if you are not using JVM features designated "experimental" or "unsafe".
3232

33-
If you compile on JDK 11+ but have users on an older JDK version, additional care is needed to avoid using APIs and features that don't exist in 8. Therefore, *compiling* on 8 may be the safest choice in this scenario. (Some Scala developers use JDK 11 or 17 for their daily work, but do release builds on JDK 8.)
34-
35-
Additionally, you can also run your Scala application on GraalVM which is a JVM. GraalVM performs well on the Scala benchmarks, and it benefits from GraalVM runtime and runs faster too.
33+
JDK 8 remains in use at many shops (as of early 2022), but usage is declining and some projects are dropping support. If you compile on JDK 11+ but want to allow your users to stay on 8, additional care is needed to avoid using APIs and features that don't exist in 8. (For this reason, some Scala developers use JDK 11 or 17 for their daily work but do release builds on JDK 8.)
3634

3735
## Long Term Support (LTS) versions
3836

@@ -50,9 +48,9 @@ In almost every case, you're free to use the JDK and JVM of your choice.
5048

5149
JDK 8 users typically use the Oracle JDK or some flavor of OpenJDK.
5250

53-
Most JDK 11+ users are using either OpenJDK or GraalVM which runs in the context of OpenJDK.
51+
Most JDK 11+ users are using OpenJDK, or GraalVM which runs in the context of OpenJDK. GraalVM performs well on the Scala benchmarks, and it benefits from GraalVM runtime and runs faster too.
5452

55-
OpenJDK comes in various flavors, offered by different providers. We build and test Scala using [AdoptOpenJDK](https://adoptopenjdk.net) in particular, but the differences are unlikely to matter to most users.
53+
OpenJDK comes in various flavors, offered by different providers. We build and test Scala using [Temurin](https://adoptium.net) primarily, but the differences are unlikely to matter to most users.
5654

5755
## JDK 11 compatibility notes
5856

0 commit comments

Comments
 (0)