From 984fcc5726f9705731e8377b5655e45545d19a46 Mon Sep 17 00:00:00 2001 From: "scala-center-steward[bot]" <111975575+scala-center-steward[bot]@users.noreply.github.com> Date: Fri, 17 May 2024 00:15:16 +0000 Subject: [PATCH 01/10] Update scala3-library to 3.4.2 --- bin/generate-proposal-listing.scala | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/bin/generate-proposal-listing.scala b/bin/generate-proposal-listing.scala index 516f957..1855dd8 100644 --- a/bin/generate-proposal-listing.scala +++ b/bin/generate-proposal-listing.scala @@ -1,4 +1,4 @@ -//> using scala "3.4.1" +//> using scala "3.4.2" //> using dep com.vladsch.flexmark:flexmark-all:0.64.8 import java.io.PrintWriter From 8d2cbede3c8e8eba1a067babcbe9949e2950a89d Mon Sep 17 00:00:00 2001 From: "scala-center-steward[bot]" <111975575+scala-center-steward[bot]@users.noreply.github.com> Date: Fri, 26 Jul 2024 00:16:09 +0000 Subject: [PATCH 02/10] Update scalafmt-core to 3.8.3 --- bin/.scalafmt.conf | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/bin/.scalafmt.conf b/bin/.scalafmt.conf index a3fffdf..1d5e456 100644 --- a/bin/.scalafmt.conf +++ b/bin/.scalafmt.conf @@ -1,4 +1,4 @@ -version = "3.8.1" +version = "3.8.3" runner.dialect = scala3 rewrite.scala3.convertToNewSyntax = yes From 1fb15ac5bcc3ab58a74e00a6c7b99ea81bab35d4 Mon Sep 17 00:00:00 2001 From: "scala-center-steward[bot]" <111975575+scala-center-steward[bot]@users.noreply.github.com> Date: Thu, 15 Aug 2024 00:16:42 +0000 Subject: [PATCH 03/10] Update scala3-library to 3.4.3 --- bin/generate-proposal-listing.scala | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/bin/generate-proposal-listing.scala b/bin/generate-proposal-listing.scala index 1855dd8..4b0df65 100644 --- a/bin/generate-proposal-listing.scala +++ b/bin/generate-proposal-listing.scala @@ -1,4 +1,4 @@ -//> using scala "3.4.2" +//> using scala "3.4.3" //> using dep com.vladsch.flexmark:flexmark-all:0.64.8 import java.io.PrintWriter From 402cbec3cb35d866309a5270c309113f726097ab Mon Sep 17 00:00:00 2001 From: "scala-center-steward[bot]" <111975575+scala-center-steward[bot]@users.noreply.github.com> Date: Fri, 23 Aug 2024 00:17:34 +0000 Subject: [PATCH 04/10] Update scala3-library to 3.5.0 --- bin/generate-proposal-listing.scala | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/bin/generate-proposal-listing.scala b/bin/generate-proposal-listing.scala index 4b0df65..a74a962 100644 --- a/bin/generate-proposal-listing.scala +++ b/bin/generate-proposal-listing.scala @@ -1,4 +1,4 @@ -//> using scala "3.4.3" +//> using scala "3.5.0" //> using dep com.vladsch.flexmark:flexmark-all:0.64.8 import java.io.PrintWriter From 274d314bd2d63cf9269a701393ed81f5b438f1fe Mon Sep 17 00:00:00 2001 From: "scala-center-steward[bot]" <111975575+scala-center-steward[bot]@users.noreply.github.com> Date: Sat, 21 Sep 2024 00:17:44 +0000 Subject: [PATCH 05/10] Update scala3-library to 3.5.1 --- bin/generate-proposal-listing.scala | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/bin/generate-proposal-listing.scala b/bin/generate-proposal-listing.scala index a74a962..f8727ae 100644 --- a/bin/generate-proposal-listing.scala +++ b/bin/generate-proposal-listing.scala @@ -1,4 +1,4 @@ -//> using scala "3.5.0" +//> using scala "3.5.1" //> using dep com.vladsch.flexmark:flexmark-all:0.64.8 import java.io.PrintWriter From 9f81381a2754b27b47003ba9677223528e4a176c Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 9 Oct 2024 19:00:28 -0700 Subject: [PATCH 06/10] build(deps): bump coursier/setup-action from 1.3.5 to 1.3.6 (#162) Bumps [coursier/setup-action](https://github.com/coursier/setup-action) from 1.3.5 to 1.3.6. - [Release notes](https://github.com/coursier/setup-action/releases) - [Commits](https://github.com/coursier/setup-action/compare/v1.3.5...v1.3.6) --- updated-dependencies: - dependency-name: coursier/setup-action dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> --- .github/workflows/ci.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index b41e2a1..1cf197d 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -13,7 +13,7 @@ jobs: steps: - uses: actions/checkout@v4 - uses: coursier/cache-action@v6 - - uses: coursier/setup-action@v1.3.5 + - uses: coursier/setup-action@v1.3.6 with: jvm: temurin:1.17 apps: "scala-cli" From 2568333cc721b439cde5d70abe7439a0ca85433f Mon Sep 17 00:00:00 2001 From: "scala-center-steward[bot]" <111975575+scala-center-steward[bot]@users.noreply.github.com> Date: Tue, 22 Oct 2024 19:18:15 -0700 Subject: [PATCH 07/10] Update scala3-library to 3.5.2 (#163) Co-authored-by: scala-center-steward[bot] <111975575+scala-center-steward[bot]@users.noreply.github.com> --- bin/generate-proposal-listing.scala | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/bin/generate-proposal-listing.scala b/bin/generate-proposal-listing.scala index f8727ae..4b4add6 100644 --- a/bin/generate-proposal-listing.scala +++ b/bin/generate-proposal-listing.scala @@ -1,4 +1,4 @@ -//> using scala "3.5.1" +//> using scala "3.5.2" //> using dep com.vladsch.flexmark:flexmark-all:0.64.8 import java.io.PrintWriter From 3e835929f6169476dfa001fe3b46f84a96c39d93 Mon Sep 17 00:00:00 2001 From: Zainab Ali Date: Wed, 23 Oct 2024 22:23:09 +0100 Subject: [PATCH 08/10] Propose guidance on choosing Scala between Scala LTS and Next. (#154) --- proposals/032-scala-version-guidance.md | 41 +++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 proposals/032-scala-version-guidance.md diff --git a/proposals/032-scala-version-guidance.md b/proposals/032-scala-version-guidance.md new file mode 100644 index 0000000..86bbc4b --- /dev/null +++ b/proposals/032-scala-version-guidance.md @@ -0,0 +1,41 @@ +--- +date: May 2024 +--- + +# Provide guidance on choosing between Scala LTS and Next + +## Proposer + +Proposed by Zainab Ali, Community Representative, 14th May 2024. + +## Abstract + +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](https://github.com/xebia-functional/fetch/commit/60b26afb242b1e248615c811f2c23a51d6cab6fe), [kovstas/fs2-throttler](https://github.com/kovstas/fs2-throttler/commit/e265f6d585aa55d101ddd5e631abb940fccce084) and [cquiroz/scala-java-locales](https://github.com/cquiroz/scala-java-locales/issues/490). + +The most prominent guidance in [the 2022 blog post on compatibility plans](https://www.scala-lang.org/blog/2022/08/17/long-term-compatibility-plans.html#the-future-best-practices) is outdated. [The 3.4.0 release notes](https://www.scala-lang.org/blog/2024/02/29/scala-3.4.0-and-3.3.3-released.html#-so-which-version-should-i-update-to) have better guidance, but are hard to discover. + +## Proposal + +The Scala website should include more guidance on choosing Scala versions. For example: + - There could be instructions on the [download page](https://www.scala-lang.org/download/) on choosing between LTS and Next. + - There could be an entry in the [migration guide](https://docs.scala-lang.org/scala3/guides/migration/compatibility-intro.html) on which version to choose. + - The [2022 blog post on compatibility plans](https://www.scala-lang.org/blog/2022/08/17/long-term-compatibility-plans.html#the-future-best-practices) 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](https://github.com/scala/scala3/releases/tag/3.4.1). + - [Scala Steward's](https://github.com/scala-steward-org/scala-steward) PRs for Scala version upgrades could include explicit guidance and instructions on [pinning LTS](https://github.com/scala-steward-org/scala-steward/blob/main/docs/faq.md#how-can-version-updates-be-controlled). + - 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. + +## Cost + +In level of difficulty I estimate the following order (from easiest to +hardest): + +1. Updating guidance on the Scala website. +2. Updating Scala Steward's PR summary. +3. Including guidance in build tool publishing steps. + +## Timescales + +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. From ae8c6fd381b059d7b5d94f9b68f6f061b4d7dfa8 Mon Sep 17 00:00:00 2001 From: Github Actions Date: Wed, 23 Oct 2024 21:23:38 +0000 Subject: [PATCH 09/10] auto update proposal listing --- proposals/README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/proposals/README.md b/proposals/README.md index 75d306a..aabdefd 100644 --- a/proposals/README.md +++ b/proposals/README.md @@ -187,5 +187,7 @@ * Date proposed: June 15 2023 * Accepted: yes * Status: **completed** +# [032-scala-version-guidance.md](./032-scala-version-guidance.md) +* Date proposed: May 2024 _This file is auto-generated. Don't edit here, instead run scala-cli run bin/ to regenerate._ \ No newline at end of file From af1d9761c500aa99f6db79cbadc87cb0983336aa Mon Sep 17 00:00:00 2001 From: Seth Tisue Date: Wed, 23 Oct 2024 14:26:24 -0700 Subject: [PATCH 10/10] update proposal script --- bin/generate-proposal-listing.scala | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) mode change 100644 => 100755 bin/generate-proposal-listing.scala diff --git a/bin/generate-proposal-listing.scala b/bin/generate-proposal-listing.scala old mode 100644 new mode 100755 index 4b4add6..3e8224b --- a/bin/generate-proposal-listing.scala +++ b/bin/generate-proposal-listing.scala @@ -1,4 +1,6 @@ -//> using scala "3.5.2" +#!/usr/local/bin/env -S scala-cli shebang + +//> using scala 3.5.2 //> using dep com.vladsch.flexmark:flexmark-all:0.64.8 import java.io.PrintWriter