Skip to content

Commit f37d18a

Browse files
committed
docs: Review wording fixes
1 parent ea56862 commit f37d18a

File tree

1 file changed

+16
-17
lines changed

1 file changed

+16
-17
lines changed

_posts/2024-10-24-post-mortem-3.6.0.md

Lines changed: 16 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -11,12 +11,12 @@ Central_
1111

1212
On Friday, 18th of October 2024, during the publication process of **3.6.0-RC1**
1313
an incident occurred that ended up in publishing Scala **3.6.0** instead. After
14-
an internal investigation, we pinpointed the incident to be of technical nature.
14+
an internal investigation, we pinpointed the incident to be technical in nature.
1515

16-
Within one hour of catching the issue, the
17-
[Scala Core Team](https://scala-lang.org/scala-core/) mitigated the problem and
18-
started the Scala **3.6.1** release – that is to be treated as RC, which is
19-
available since Saturday 19th October. Scala **3.6.0** was abandoned and
16+
Within one hour of the issue being reported, the
17+
[Scala Core Team](https://scala-lang.org/scala-core/) mitigated the problem by
18+
starting the Scala **3.6.1** release – which is to be treated like an RC; it has
19+
been available since Saturday 19th October. Scala **3.6.0** was abandoned and
2020
promptly announced to the public as broken.
2121

2222
We apologize to the Scala users for any inconvenience it might have caused. We
@@ -40,23 +40,22 @@ sometime in the second half of November.
4040
## How does it affect users?
4141

4242
Scala 3.6.0 is a broken release \- it should never be used by users of Scala.
43-
The results of the compilation might not be consumed by stable versions of the
43+
The results of the compilation might not be consumable by stable versions of the
4444
compiler or TASTy based tooling.
4545
Tooling that automatically uses the latest available version of Scala will use
4646
the hot-fix release 3.6.1, which should be treated as a Release Candidate
4747
version. We don’t encourage most users to upgrade yet, unless for testing
48-
purposes. Instead, use the stable 3.5.2 and wait with upgrades until 3.6.2 is
49-
out.
48+
purposes. Instead, use the stable 3.5.2 and wait to upgrade until 3.6.2 is out.
5049

5150
## What happened?
5251

53-
During the publication of Scala **3.6.0-RC1** to the Sonatype Maven
54-
repository**,** a mistake occurred and we released **a misconfigured 3.6.0**
55-
instead. As a result, the released version of the compiler produces TASTy files
56-
in the experimental version that cannot be consumed by stable TASTy consumers
57-
(e.g. the Scala compiler, tasty-query, Scaladoc). Setting the TASTy version to
58-
an experimental one is a standard procedure when releasing a new release
59-
candidate of a minor version of Scala 3\.
52+
During the publication of Scala **3.6.0-RC1** to the Sonatype Maven repository,
53+
a mistake occurred and we released **a misconfigured 3.6.0** instead. As a
54+
result, the released version of the compiler produces TASTy files in the
55+
experimental version that cannot be consumed by stable TASTy consumers (e.g. the
56+
Scala compiler, tasty-query, Scaladoc). Setting the TASTy version to an
57+
experimental one is a standard procedure when releasing a new release candidate
58+
of a minor version of Scala 3.
6059

6160
## What immediate steps were taken?
6261

@@ -90,7 +89,7 @@ libraries produced by Scala 3.6.1 or later.
9089
We decided to publish Scala 3.6.1 as a follow-up ASAP so that the most recent
9190
version doesn’t include the experimental TASTy flag nor RC settings. With 3.6.1
9291
we ensured tooling will, at the very least, refer to a Scala version that
93-
actually could be considered stable.
92+
actually could be considered reasonably stable.
9493

9594
We don’t yet encourage users to upgrade to Scala 3.6.1 on their own, except for
9695
testing purposes. Users should wait with upgrades until a future announcement.
@@ -135,6 +134,6 @@ the following processes as preventative measures:
135134
- Additional, manual approval of published artifacts to the staging Maven
136135
repository.
137136
- We will be mindful of the day of week for releases, and avoid Thursdays and
138-
Fridays at all costs.
137+
Fridays.
139138
- We will ensure that every change associated with the release process is well
140139
documented internally.

0 commit comments

Comments
 (0)