From 9459c8fae99acd3100cb15a3349352b95ff0e641 Mon Sep 17 00:00:00 2001 From: Eugene Yokota Date: Mon, 20 Jan 2025 13:48:56 -0500 Subject: [PATCH] Demote cs setup **Problem** Currently the website puts `cs setup` on the top item as a way of installing sbt, however, the users seem to run into issues with `cs setup`, which is not great for the out-of-box experience of sbt. **Solution** Promote more reliable way of installing sbt. --- src/pages/download.mdx | 36 +++++++++++++++++++----------------- 1 file changed, 19 insertions(+), 17 deletions(-) diff --git a/src/pages/download.mdx b/src/pages/download.mdx index 1db52ad1..548cdb6f 100644 --- a/src/pages/download.mdx +++ b/src/pages/download.mdx @@ -11,17 +11,17 @@ import HomepageVersions from '@site/src/components/HomepageVersions'; Download ======== -Install sbt with **cs setup** ------------------------------ +Universal packages +------------------ -Follow [Install](https://www.scala-lang.org/download/) page, and install Scala using Coursier. +The most reliable way to install sbt is to use SDKMAN or manually install from the universal packages. -```bash -cs setup -sbt --script-version -``` - -This should install the latest stable version of `sbt`. +- sbt-{sbtVersion}.zip +- sbt-{sbtVersion}.zip.sha256 +- sbt-{sbtVersion}.zip.asc +- sbt-{sbtVersion}.tgz +- sbt-{sbtVersion}.tgz.sha256 +- sbt-{sbtVersion}.tgz.asc @@ -84,15 +84,17 @@ sudo yum install sbt -Universal packages ------------------- +Coursier (cs setup) +------------------- -- sbt-{sbtVersion}.zip -- sbt-{sbtVersion}.zip.sha256 -- sbt-{sbtVersion}.zip.asc -- sbt-{sbtVersion}.tgz -- sbt-{sbtVersion}.tgz.sha256 -- sbt-{sbtVersion}.tgz.asc +:::warning +Install the latest Coursier before attempting the following steps. +There are multiple bug reports on `cs setup`. See [coursier#2953](https://github.com/coursier/coursier/issues/2953), [#7278](https://github.com/sbt/sbt/issues/7278) etc. +::: + +```bash +cs setup +``` ### Previous releases