Skip to content

Converge on one get-started instructions, recommend on landing page #1344

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 4 commits into from
Mar 3, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions _data/scala-releases.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
- category: current_version
title: Current 3.1.x release
version: 3.1.1
release_date: February 1, 2022
- category: current_version
title: Current 2.13.x release
version: 2.13.8
release_date: January 12, 2022
- category: maintenance_version
title: Latest 2.12.x maintenance release
version: 2.12.15
release_date: September 14, 2021
- category: maintenance_version
title: Last 2.11.x maintenance release
version: 2.11.12
release_date: November 9, 2017
- category: maintenance_version
title: Last 2.10.x maintenance release
version: 2.10.7
release_date: November 9, 2017
1 change: 1 addition & 0 deletions _downloads/2019-08-05-2.12.9.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ release_date: "August 05, 2019"
show_resources: "true"
permalink: /download/2.12.9.html
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
resources: [
["-main-unixsys", "scala-2.12.9.tgz", "https://downloads.lightbend.com/scala/2.12.9/scala-2.12.9.tgz", "Mac OS X, Unix, Cygwin", "19.69M"],
["-main-windows", "scala-2.12.9.msi", "https://downloads.lightbend.com/scala/2.12.9/scala-2.12.9.msi", "Windows (msi installer)", "124.01M"],
Expand Down
1 change: 1 addition & 0 deletions _downloads/2019-09-10-2.12.10.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ release_date: "September 10, 2019"
show_resources: "true"
permalink: /download/2.12.10.html
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
resources: [
["-main-unixsys", "scala-2.12.10.tgz", "https://downloads.lightbend.com/scala/2.12.10/scala-2.12.10.tgz", "Mac OS X, Unix, Cygwin", "19.71M"],
["-main-windows", "scala-2.12.10.msi", "https://downloads.lightbend.com/scala/2.12.10/scala-2.12.10.msi", "Windows (msi installer)", "124M"],
Expand Down
1 change: 1 addition & 0 deletions _downloads/2020-03-16-2.12.11.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ release_date: "March 16, 2020"
show_resources: "true"
permalink: /download/2.12.11.html
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
resources: [
["-main-unixsys", "scala-2.12.11.tgz", "https://downloads.lightbend.com/scala/2.12.11/scala-2.12.11.tgz", "Mac OS X, Unix, Cygwin", "19.83M"],
["-main-windows", "scala-2.12.11.msi", "https://downloads.lightbend.com/scala/2.12.11/scala-2.12.11.msi", "Windows (msi installer)", "124.33M"],
Expand Down
1 change: 1 addition & 0 deletions _downloads/2020-07-13-2.12.12.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ release_date: "July 13, 2020"
show_resources: "true"
permalink: /download/2.12.12.html
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
resources: [
["-main-unixsys", "scala-2.12.12.tgz", "https://downloads.lightbend.com/scala/2.12.12/scala-2.12.12.tgz", "Mac OS X, Unix, Cygwin", "19.87M"],
["-main-windows", "scala-2.12.12.msi", "https://downloads.lightbend.com/scala/2.12.12/scala-2.12.12.msi", "Windows (msi installer)", "124.70M"],
Expand Down
1 change: 1 addition & 0 deletions _downloads/2021-01-12-2.12.13.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ release_date: "January 12, 2021"
show_resources: "true"
permalink: /download/2.12.13.html
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
resources: [
["-main-unixsys", "scala-2.12.13.tgz", "https://downloads.lightbend.com/scala/2.12.13/scala-2.12.13.tgz", "Mac OS X, Unix, Cygwin", "20.03M"],
["-main-windows", "scala-2.12.13.msi", "https://downloads.lightbend.com/scala/2.12.13/scala-2.12.13.msi", "Windows (msi installer)", "125.69M"],
Expand Down
1 change: 1 addition & 0 deletions _downloads/2021-02-22-2.13.5.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ release_date: "February 22, 2021"
show_resources: "true"
permalink: /download/2.13.5.html
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
resources: [
["-main-unixsys", "scala-2.13.5.tgz", "https://downloads.lightbend.com/scala/2.13.5/scala-2.13.5.tgz", "Mac OS X, Unix, Cygwin", "21.98M"],
["-main-windows", "scala-2.13.5.msi", "https://downloads.lightbend.com/scala/2.13.5/scala-2.13.5.msi", "Windows (msi installer)", "130.48M"],
Expand Down
1 change: 1 addition & 0 deletions _downloads/2021-05-28-2.12.14.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ release_date: "May 28, 2021"
show_resources: "true"
permalink: /download/2.12.14.html
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
resources: [
["-main-unixsys", "scala-2.12.14.tgz", "https://downloads.lightbend.com/scala/2.12.14/scala-2.12.14.tgz", "Mac OS X, Unix, Cygwin", "20.11M"],
["-main-windows", "scala-2.12.14.msi", "https://downloads.lightbend.com/scala/2.12.14/scala-2.12.14.msi", "Windows (msi installer)", "125.83M"],
Expand Down
1 change: 1 addition & 0 deletions _downloads/2021-09-14-2.12.15.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ release_date: "September 14, 2021"
show_resources: "true"
permalink: /download/2.12.15.html
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
resources: [
["-main-unixsys", "scala-2.12.15.tgz", "https://downloads.lightbend.com/scala/2.12.15/scala-2.12.15.tgz", "Mac OS X, Unix, Cygwin", "20.11M"],
["-main-windows", "scala-2.12.15.msi", "https://downloads.lightbend.com/scala/2.12.15/scala-2.12.15.msi", "Windows (msi installer)", "125.48M"],
Expand Down
1 change: 1 addition & 0 deletions _downloads/2021-11-01-2.13.7.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ release_date: "November 01, 2021"
show_resources: "true"
permalink: /download/2.13.7.html
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
resources: [
["-main-unixsys", "scala-2.13.7.tgz", "https://downloads.lightbend.com/scala/2.13.7/scala-2.13.7.tgz", "Mac OS X, Unix, Cygwin", "22.64M"],
["-main-windows", "scala-2.13.7.msi", "https://downloads.lightbend.com/scala/2.13.7/scala-2.13.7.msi", "Windows (msi installer)", "134.43M"],
Expand Down
1 change: 1 addition & 0 deletions _downloads/2022-01-12-2.13.8.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ release_date: "January 12, 2022"
show_resources: "true"
permalink: /download/2.13.8.html
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
resources: [
["-main-unixsys", "scala-2.13.8.tgz", "https://downloads.lightbend.com/scala/2.13.8/scala-2.13.8.tgz", "Mac OS X, Unix, Cygwin", "22.65M"],
["-main-windows", "scala-2.13.8.msi", "https://downloads.lightbend.com/scala/2.13.8/scala-2.13.8.msi", "Windows (msi installer)", "134.43M"],
Expand Down
77 changes: 41 additions & 36 deletions _includes/download-resource-list.html
Original file line number Diff line number Diff line change
@@ -1,51 +1,56 @@
<div class="content-primary">
<div class="text-step">

<h3 id="other-releases">Other Releases</h3>
{% if page.resources.size > 0 %}
<h3>Other resources</h3>

<p>You can find the installer download links for other operating systems, as well as documentation and source code
archives for Scala {{page.release_version}} below.</p>

<table>
<thead>
<tr>
<th style="text-align: left">Archive</th>
<th style="text-align: left">System</th>
{% unless page.dont_show_sizes %}
<th style="text-align: left">Size</th>
{% endunless %}
</tr>
</thead>

<tbody>
{% for resource in page.resources %}
<tr>
<td style="text-align: left">
<a id="#link{{ resource[0] }}" href="{{ resource[2] }}">
{{ resource[1] }}
</a>
</td>
<td style="text-align: left">{{ resource[3] }}</td>
{% unless page.dont_show_sizes %}
<td style="text-align: left">{{ resource[4] }}</td>
{% endunless %}
</tr>
{% endfor %}
</tbody>
</table>
{% endif %}

<h2 id="other-releases">Other Releases</h2>

<p>You can find the links to prior versions or the latest development version below.
To see a detailed list of changes for each version of Scala please refer to the <a href="{{ site.baseurl }}/download/changelog.html">changelog</a>.</p>

<p>Note that different major releases of Scala (e.g. Scala 2.11.x and Scala 2.12.x) are not binary compatible with each other.</p>

<ul>
{% for release in page.other_releases %}
<li>{{ release[1] }}:
{% for release in site.data.scala-releases %}
<li>{{ release.title }}:
<ul>
<li><a href="/download/{{ release[2] }}.html">Scala {{ release[2] }}</a> - Released on {{ release[3] }}</li>
<li><a href="/download/{{ release.version }}.html">Scala {{ release.version }}</a> - Released on {{ release.release_date }}</li>
</ul></li>
{% endfor %}
<li><a href="https://scala-lang.org/files/archive/nightly/">Nightly builds</a></li>
<li><a href="/download/changelog.html">Changelog</a></li>
<li><a href="/download/all.html">All previous releases</a></li>
<li><a href="/download/all.html">All Scala releases</a></li>
</ul>

<h3>Other resources</h3>

<p>You can find the installer download links for other operating systems, as well as documentation and source code archives for Scala {{page.release_version}} below.</p>

<table>
<thead><tr>
<th style="text-align: left">Archive</th>
<th style="text-align: left">System</th>
{% unless page.dont_show_sizes %}
<th style="text-align: left">Size</th>
{% endunless %}
</tr></thead>

<tbody>
{% for resource in page.resources %}
<tr>
<td style="text-align: left">
<a id="#link{{ resource[0] }}" href="{{ resource[2] }}">
{{ resource[1] }}
</a>
</td>
<td style="text-align: left">{{ resource[3] }}</td>
{% unless page.dont_show_sizes %}
<td style="text-align: left">{{ resource[4] }}</td>
{% endunless %}
</tr>
{% endfor %}
</tbody>
</table>
</div>
128 changes: 45 additions & 83 deletions _includes/downloads-scala2.html
Original file line number Diff line number Diff line change
@@ -1,87 +1,49 @@
<h2>The most popular way to get Scala is either using Scala through sbt, the Scala build tool, or to use Scala through an IDE.</h2>
<div class="install-steps">
<div class="step arrow">
<img src="/resources/img/download/arrow-asset.png" alt="">
<div class="number-step">1</div>
<div class="text-step">
<h3>First, make sure you have the Java 8 JDK (or Java 11 JDK) installed.</h3>
<p>To check, open the terminal and type:</p>
<p><code>java -version</code><span>(Make sure you have version 1.8 or 11.)</span></p>
<p><i>(If you don't have it installed, download Java from <a href="https://www.oracle.com/java/technologies/javase-jdk8-downloads.html">Oracle Java 8</a>, <a href="https://www.oracle.com/java/technologies/javase-jdk11-downloads.html">Oracle Java 11</a>, or <a href="https://adoptopenjdk.net/">AdoptOpenJDK 8/11</a>. Refer <a href="https://docs.scala-lang.org/overviews/jdk-compatibility/overview.html">JDK Compatibility</a> for Scala/Java compatiblity detail.</i></p>
</div>
</div>
<div class="step">
<div class="number-step">2</div>
<div class="text-step">
<h3>Then, install Scala:</h3>
<p>...either by installing an IDE such as IntelliJ, or sbt, Scala's build tool.</p>
</div>
</div>
<div class="download-options">
<div class="download-left">
<span class="or">or</span>
<div class="description">
<img src="/resources/img/download/arrow-left.png" alt="">
<p>Best if you prefer a full-featured IDE (recommended for beginners)</p>
</div>
<a href="https://www.jetbrains.com/idea" class="btn-download" id="download-intellij-link">
<i class="fa fa-download"></i>
<span>Download intellij</span>
</a>
<ul>
{% include tutorial-list.html column=1 %}
</ul>
</div>
<div class="download-right">
<div class="description">
<img src="/resources/img/download/arrow-right.png" alt="">
<p>Best if you are familiar with the command line</p>
</div>
<a href="https://www.scala-sbt.org/download.html" class="btn-download" id="download-sbt-link">
<i class="fa fa-download"></i>
<span>Download Sbt</span>
</a>
<ul>
{% include tutorial-list.html column=0 %}
</ul>
</div>
</div>

<p class="bottom-lead">
Compared to other programming languages, installing Scala is a bit unusual. Scala is unusual because it is usually installed for each of your Scala projects rather than being installed system-wide. Both of the above options manage (via sbt) a specific Scala version per Scala project you create.
<br><br>
But it's also possible to "install" Scala in numerous other ways; e.g., grab Scala binaries and use Scala from the command line or use Scala in your browser!
<br><br>
</p>
<p>Are you looking for <a href="{{ site.baseurl }}/download/all.html">another release</a> of Scala?</p>
<h3>Release Notes</h3>
For a summary of important changes, see the <a href="https://github.com/scala/scala/releases">GitHub release notes</a>.
<br/><small>(Or consult our archive of <a href="{{ site.baseurl }}/blog/announcements/">older release
notes</a>.)</small>

<!-- <p class="bottom-lead"><h2>Other</h2></p> -->

<div class="step other-ways-lead">
<div class="number-step"><i class="fa fa-ellipsis-h" aria-hidden="true"></i></div>
<div class="text-step">
<h2>Other ways to install Scala</h2>
<ul>
<li>
<a id="download-binaries">Download the Scala binaries for <span id="users-os"></span></a>
<br/><span class="install"><a href="{{ site.baseurl }}/download/install.html">Need help running the binaries?</a></span>
</li>
<li>Using <a href="https://sdkman.io/">SDKMAN!</a>, you can easily <a href="https://sdkman.io/sdks#scala">install specific versions of Scala</a> on any platform with <code>sdk install scala {{ site.scalaversion }}</code></li>
<li>On macOS you can also use <a href="https://brew.sh/">Homebrew</a> and existing <a href="https://formulae.brew.sh/formula/scala">Scala Formulae</a><br/><code>brew update</code><br/><code>brew install scala</code></li>
<li>With <a href="https://www.macports.org/">MacPorts</a>, you can get Scala using <code>sudo port install scala2.x</code>command.<br/> For example to install Scala 2.12 simply use<code>sudo port install scala2.12</code></li>
<li>Use <a href="https://scastie.scala-lang.org">Scastie</a> to run single-file Scala programs in your browser using multiple Scala compilers; the production Scala 2.x compilers, Scala.js, Dotty, and Typelevel Scala. Save and share executable Scala code snippets.</li>
<li>Try Scala in the browser via <a href="https://scalafiddle.io/">ScalaFiddle</a>. This lets you run single-file Scala programs in your browser using Scala.js, including graphical/interactive examples such as <a href="https://scalafiddle.io/sf/KOsXSKv/0">Oscilloscope</a> or <a href="https://scalafiddle.io/sf/4beVrVc/1">Ray Tracer</a></li>
<li><a href="https://ammonite.io/">Get Ammonite</a>, a popular Scala REPL</li>
</ul>
<p>Or are you looking for <a href="{{ site.baseurl }}/download/all.html">previous releases</a> of Scala?</p>
</div>
<div class="install-steps">
<div class="text-step">
<h2>Ways to Install This Release</h2>
<ul>
<li>
Using <a
href="https://docs.scala-lang.org/getting-started/index.html#using-the-scala-installer-recommended-way">Coursier
CLI</a>, run:<br>
<code>cs install scala:{{ page.release_version }} && cs install scalac:{{ page.release_version }}</code>.
</li>
<li>
<a id="download-binaries">Download the Scala binaries for <span id="users-os"></span></a>
<br /><span class="install"><a href="{{ site.baseurl }}/download/install.html">Need help running the
binaries?</a></span>
</li>
<li><a href="/documentation/getting-started-intellij-track/getting-started-with-scala-in-intellij.html">Download and
use Scala</a><span> with </span><a href="https://www.jetbrains.com/idea">IntelliJ</a><span> and then </span><a
href="/documentation/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.html">build a
project</a><span>, then </span><a
href="/documentation/getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.html">test it.</a>
</li>
<li>Using <a href="https://sdkman.io/">SDKMAN!</a>, you can easily <a href="https://sdkman.io/sdks#scala">install
specific versions of Scala</a> on any platform with <code>sdk install scala {{ site.scalaversion }}</code></li>
<li>On macOS you can also use <a href="https://brew.sh/">Homebrew</a> and existing <a
href="https://formulae.brew.sh/formula/scala">Scala
Formulae</a><br /><code>brew update</code><br /><code>brew install scala</code></li>
<li>With <a href="https://www.macports.org/">MacPorts</a>, you can get Scala using
<code>sudo port install scala2.x</code>command.<br /> For example to install Scala 2.12 simply
use<code>sudo port install scala2.12</code></li>
<li>Use <a href="https://scastie.scala-lang.org">Scastie</a> to run single-file Scala programs in your browser using
multiple Scala compilers; the production Scala 2.x compilers, Scala.js, Dotty, and Typelevel Scala. Save and share
executable Scala code snippets.</li>
<li>Try Scala in the browser via <a href="https://scalafiddle.io/">ScalaFiddle</a>. This lets you run single-file
Scala programs in your browser using Scala.js, including graphical/interactive examples such as <a
href="https://scalafiddle.io/sf/KOsXSKv/0">Oscilloscope</a> or <a href="https://scalafiddle.io/sf/4beVrVc/1">Ray
Tracer</a></li>
<li><a href="https://ammonite.io/">Get Ammonite</a>, a popular Scala REPL</li>
</ul>
</div>


<h3>Release Notes</h3>
For a summary of important changes, see the <a href="https://github.com/scala/scala/releases">GitHub release notes</a>.
<br/><small>(Or consult our archive of <a href="{{ site.baseurl }}/blog/announcements/">older release notes</a>.)</small>

{% include download-resource-list.html %}
<h3>License</h3>
<p>The Scala distribution is released under the {{page.license}}.</p>
</div>
<h3>License</h3>
<p>The Scala {{ page.release_version }} distribution is released under the {{page.license}}.</p>
Loading