| date | accepted | status |
|---|---|---|
May 2024 |
true |
completed |
Proposed by Zainab Ali, Community Representative, 14th May 2024.
There is no clear guidance on how to choose between Scala LTS or Scala Next. This has lead to some open source projects adopting Next where LTS is recommended. Examples include xebiafunctional/fetch, kovstas/fs2-throttler and cquiroz/scala-java-locales.
The most prominent guidance in the 2022 blog post on compatibility plans is outdated. The 3.4.0 release notes have better guidance, but are hard to discover.
The Scala website should include more guidance on choosing Scala versions. For example:
- There could be instructions on the download page on choosing between LTS and Next.
- There could be an entry in the migration guide on which version to choose.
- The 2022 blog post on compatibility plans could include a link to recent best practices. Ideally, there should be a link to guidance wherever Next or LTS are mentioned.
Developers actively upgrading their Scala versions are unlikely to check the website, but do check other sources.
- There should be a link to guidance in the release notes.
- Scala Steward's PRs for Scala version upgrades could include explicit guidance and instructions on pinning LTS.
- Build tools such as mill, sbt, and scala-cli could potentially inform the user if a jar is configured for publishing with a Next version.
In level of difficulty I estimate the following order (from easiest to hardest):
- Updating guidance on the Scala website.
- Updating Scala Steward's PR summary.
- Including guidance in build tool publishing steps.
Updating guidance on the Scala website and release notes could be done quickly. As developers are currently in the process of adopting 3.4, the earlier this guidance is available, the better.