Skip to content

Commit b3e10c0

Browse files
authored
Merge pull request #958 from SethTisue/stdlib-sip-spp
overhaul SIP/SPP landing page
2 parents 548d9d5 + a598f6b commit b3e10c0

File tree

1 file changed

+34
-32
lines changed

1 file changed

+34
-32
lines changed

_sips/index.md

Lines changed: 34 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -4,17 +4,42 @@ title: Scala Improvement Process
44
---
55

66

7-
<div style="font-size: 1.25rem; color: #073642; font-weight: 400; font-family: 'Roboto Slab', serif; margin-bottom: 18px;"> There are <strong>two</strong> ways to make changes to Scala.</div>
7+
Two separate processes govern changes to Scala:
88

9-
<ol style="margin-bottom: 24px;">
10-
<li style="margin-bottom: 4px;">Library changes, typically to the Scala standard library and other central libraries.</li>
11-
<li style="margin-bottom: 4px;">Compiler/language changes.</li>
12-
</ol>
9+
1. The **Scala Improvement Process** (SIP) covers changes to the Scala
10+
language, the Scala compiler, and the core of the Scala standard
11+
library.
1312

14-
The Scala Platform Process (SPP) is intended for library changes, and the Scala
15-
Improvement Process (SIP) is intended for changes to the Scala compiler or
16-
language.
13+
2. The **Scala Platform Process** (SPP) aims to establish a stable
14+
collection of libraries suitable for widespread use, with a low barrier
15+
to entry for newcomers.
1716

17+
## Scala Improvement Process (SIP)
18+
19+
The **SIP** (_Scala Improvement Process_) is a process for submitting
20+
changes to the Scala language. This process aims to evolve Scala
21+
openly and collaboratively.
22+
23+
The SIP process covers the Scala language and compiler and the core of
24+
the Scala standard library. (The core is anything that is unlikely to
25+
be spun off into a separate module.)
26+
27+
A proposed change requires a design document, called a Scala
28+
Improvement Proposal (SIP). The SIP committee meets monthly to
29+
discuss, and eventually vote upon, proposals.
30+
31+
A SIP is subject to a [review process](./sip-submission.html).
32+
Proposals normally include proposed changes to the
33+
[Scala language specification](http://www.scala-lang.org/files/archive/spec/2.12/).
34+
Before reaching the committee, a proposal normally receives community
35+
discussion and review on the
36+
[Scala Contributors](https://contributors.scala-lang.org/) forum.
37+
Please read [Submitting a SIP](./sip-submission.html) and our
38+
[SIP tutorial](./sip-tutorial.html) for more information.
39+
40+
> Historical note: The SIP replaces the older SID (Scala Improvement Document) process.
41+
> Completed SID documents remain available in the
42+
> [completed section of the SIP list](sip-list.html).
1843
1944
## Scala Platform Process (SPP)
2045

@@ -23,27 +48,4 @@ use and a low barrier to entry for beginners and intermediate users. The
2348
Platform consists of several independent modules that solve specific problems.
2449
The Scala community sets the overall direction of the Platform.
2550

26-
<a class="button" href="https://scalacenter.github.io/platform/">Learn more</a>
27-
28-
29-
30-
## Scala Improvement Process (SIP)
31-
32-
The **SIP** (_Scala Improvement Process_) is a process for submitting changes to
33-
the Scala language. All changes to the language go through design documents,
34-
called Scala Improvement Proposals (SIPs), which are openly discussed by a
35-
committee and only upon reaching a consensus are accepted to be merged into the
36-
Scala compiler.
37-
38-
The aim of the Scala Improvement Process is to apply openness and collaboration
39-
to the process of evolving the language. SIPs are for changes to the Scala
40-
language and/or compiler and are subject to a [rigorous review process](./sip-submission.html)
41-
and are usually accompanied by changes to the
42-
[Scala language specification](http://www.scala-lang.org/files/archive/spec/2.12/), lots of
43-
review and discussion on the [Scala Contributors](https://contributors.scala-lang.org/) mailing list and
44-
voting/approval milestones. Please read [Submitting a SIP](./sip-submission.html) and our
45-
[SIP tutorial](./sip-tutorial.html) for more information.
46-
47-
> Note: the SIP process replaced the older SID (Scala Improvement Document) process,
48-
however the old completed SID documents are still available to review in the
49-
[completed section of the SIP list](sip-list.html).
51+
<a class="button" href="https://platform.scala-lang.org">Learn more about the Scala Platform</a>

0 commit comments

Comments
 (0)