You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .github/ISSUE_TEMPLATE/release.md
+13-5Lines changed: 13 additions & 5 deletions
Original file line number
Diff line number
Diff line change
@@ -62,14 +62,18 @@ Key links:
62
62
[scala-asm]: https://github.com/scala/scala-asm/
63
63
[ASM]: https://asm.ow2.io/versions.html
64
64
65
-
### Point of no return
65
+
### Allow time for testing
66
66
67
-
Once sufficient time for community testing has passed, it's time to cut the release!
68
-
69
-
What is "sufficient" time? A week is a bare minimum. Two weeks is a better "normal" amount. We should also respect requests from Scala Center advisory board members, if they explicitly ask for additional testing time. (In the past, we sometimes only waited a day or two, but this was overly optimistic in presuming that people had been testing nightlies all along.)
67
+
How much time is sufficient? A week is a bare minimum. Two weeks is a better "normal" amount. We should also respect requests from Scala Center advisory board members, if they explicitly ask for additional testing time. (In the past, we sometimes only waited a day or two, but this was overly optimistic in presuming that people had been testing nightlies all along.)
70
68
71
69
Be mindful of others' schedules; even minor releases make work downstream (for Scala.js and Scala Native, for the Scala 3 team, for compiler plugin authors, and so on). And a botched release might make unexpected work for ourselves as well as for others. So it's better not to release on a Friday or even a Thursday, or too close to a major holiday. And it's best to release while everyone in both America and Europe is awake. (First thing in the morning in America is a good choice.)
72
70
71
+
### Stage! (point of soft no-return)
72
+
73
+
Once sufficient time for community testing has passed, it's time to stage the release!
74
+
75
+
We call this "soft" no-return because even staged artifacts can end up in local caches and cause confusion.
76
+
73
77
-[ ] Make sure there are no stray [staging repos](https://oss.sonatype.org/#stagingRepositories) on Sonatype
74
78
-[ ] Trigger a custom build on [travis](https://app.travis-ci.com/github/scala/scala)
75
79
- Select the correct branch
@@ -85,7 +89,11 @@ Be mindful of others' schedules; even minor releases make work downstream (for S
- in particular, if the release was staged multiple times, double check that https://oss.sonatype.org/content/repositories/staging/ has the files from the most recent build
87
91
-[ ] Check that JARs haven't mysteriously bloated — compare sizes to previous release. We have no other backstop for this.
88
-
- Remember, tags are forever, so are maven artifacts (even staged ones, as they could end up in local caches) and S3 uploads (S3 buckets can be changed, but it can takes days to become consistent)
92
+
93
+
### Release! (point of hard no-return)
94
+
95
+
"Hard" no-return because Maven Central is forever. Also, S3 uploads should be treated as forever (S3 buckets can be changed, but it can takes days to become consistent). Tags, too, should be treated as forever, even though they can technically be deleted and re-pushed.
0 commit comments