Skip to content

Commit 9459c8f

Browse files
committed
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.
1 parent 953cb4b commit 9459c8f

File tree

1 file changed

+19
-17
lines changed

1 file changed

+19
-17
lines changed

src/pages/download.mdx

+19-17
Original file line numberDiff line numberDiff line change
@@ -11,17 +11,17 @@ import HomepageVersions from '@site/src/components/HomepageVersions';
1111
Download
1212
========
1313

14-
Install sbt with **cs setup**
15-
-----------------------------
14+
Universal packages
15+
------------------
1616

17-
Follow [Install](https://www.scala-lang.org/download/) page, and install Scala using Coursier.
17+
The most reliable way to install sbt is to use SDKMAN or manually install from the universal packages.
1818

19-
```bash
20-
cs setup
21-
sbt --script-version
22-
```
23-
24-
This should install the latest stable version of `sbt`.
19+
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".zip") }>sbt-{sbtVersion}.zip</a>
20+
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".zip.sha256") }>sbt-{sbtVersion}.zip.sha256</a>
21+
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".zip.asc") }>sbt-{sbtVersion}.zip.asc</a>
22+
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".tgz") }>sbt-{sbtVersion}.tgz</a>
23+
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".tgz.sha256") }>sbt-{sbtVersion}.tgz.sha256</a>
24+
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".tgz.asc") }>sbt-{sbtVersion}.tgz.asc</a>
2525

2626
<Tabs groupId="operating-systems">
2727
<TabItem value="mac" label="macOS">
@@ -84,15 +84,17 @@ sudo yum install sbt
8484
</TabItem>
8585
</Tabs>
8686

87-
Universal packages
88-
------------------
87+
Coursier (cs setup)
88+
-------------------
8989

90-
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".zip") }>sbt-{sbtVersion}.zip</a>
91-
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".zip.sha256") }>sbt-{sbtVersion}.zip.sha256</a>
92-
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".zip.asc") }>sbt-{sbtVersion}.zip.asc</a>
93-
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".tgz") }>sbt-{sbtVersion}.tgz</a>
94-
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".tgz.sha256") }>sbt-{sbtVersion}.tgz.sha256</a>
95-
- <a href={ downloadUrl(sbtVersion, sbtVersion, ".tgz.asc") }>sbt-{sbtVersion}.tgz.asc</a>
90+
:::warning
91+
Install the latest Coursier before attempting the following steps.
92+
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.
93+
:::
94+
95+
```bash
96+
cs setup
97+
```
9698

9799
### Previous releases
98100

0 commit comments

Comments
 (0)