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
[wiki migration] Pages under docs/postmortems/ (flutter#148798)
This moves the wiki pages that have a final destination under docs/postmortems/ as planned in [flutter.dev/go/migrate-flutter-wiki-spreadsheet](https://docs.google.com/spreadsheets/d/1x65189ZBdNiLRygpUYoU08pwvXD4M-Z157c6pm8deGI/edit?usp=sharing)
It also adds the team labels to the label bot for future PRs.
Changes to the content were only updating cross links, or links to refer to the main branch rather than master.
Remaining links to the wiki will be updated once all other pages have finished moving, they still work in the meantime.
Part of flutter#145009
Copy file name to clipboardExpand all lines: docs/postmortems/Postmortem-Beta-1-Release.md
+8-8Lines changed: 8 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,7 +25,7 @@ Description: Flutter launched beta 1 on February 27, 2018. This document attemp
25
25
|_14:40_|[@timsneath](https://github.com/timsneath) runs into more trouble upgrading. [@tvolkert](https://github.com/tvolkert) begins trying to diagnose based on the reports. |
26
26
|_16:53_| After a few back-and-forths with [@timsneath](https://github.com/timsneath) over email, [@tvolkert](https://github.com/tvolkert) enlists the help of [@jason-simmons](https://github.com/jason-simmons) and [@cbracken](https://github.com/cbracken) in tracking down the cause for the problems [@timsneath](https://github.com/timsneath) is encountering. The goal is to determine whether the problems are an outlier unique to [@timsneath's](https://github.com/timsneath) setup or whether they’re likely to affect most users once the influx of users begins. |
27
27
|_17:30_|[@jason-simmons](https://github.com/jason-simmons) discovers that before [#14507](https://github.com/flutter/flutter/pull/14507) (v0.0.24), the “channel” command could create local (non-tracking) branches and that if [@timsneath](https://github.com/timsneath) was bitten by this, it would explain the behavior he’s seeing. The team tentatively decides the errors that [@timsneath](https://github.com/timsneath) is seeing are likely an outlier. |
28
-
|_20:00_|[@tvolkert](https://github.com/tvolkert) manages to reconstruct [@timsneath's](https://github.com/timsneath) environment setup and confirms [@jason-simmons'](https://github.com/jason-simmons) theory. The team adds a [section to the wiki](https://github.com/flutter/flutter/wiki/Flutter-build-release-channels#workaround) covering this case for users who may run into it. |
28
+
|_20:00_|[@tvolkert](https://github.com/tvolkert) manages to reconstruct [@timsneath's](https://github.com/timsneath) environment setup and confirms [@jason-simmons'](https://github.com/jason-simmons) theory. The team adds a [section to the wiki](../releases/Flutter-build-release-channels.md#workaround) covering this case for users who may run into it. |
29
29
30
30
### _2018/02/27_
31
31
@@ -58,7 +58,7 @@ Description: Flutter launched beta 1 on February 27, 2018. This document attemp
58
58
59
59
* Our internal Google tests purposely don’t exercise our external build code paths (e.g. Gradle builds) — since within Google, everything is built using Bazel. This meant that although the gallery was unable to be built on the beta branch ([#14912](https://github.com/flutter/flutter/issues/14912)), we had no knowledge of this failure until after beta was pushed (and [@mit-mit](https://github.com/mit-mit) manually discovered the breakage). The bug had actually already been fixed on a newer dev build (in [#14714](https://github.com/flutter/flutter/pull/14714)), but we didn’t mark the affected build range as bad until after this was discovered and traced back to code that pointed to the existing fix. Our external tests were also [allowing failures on Travis](https://github.com/flutter/flutter/blob/5b46e0a4bef24e1c1302ba3ca40a99bd20a192da/.travis.yml#L18-L19), which was intentional at the time because we didn’t yet have confidence in those tests. In addition to fixing the issue, [#14714](https://github.com/flutter/flutter/pull/14714) also enabled those tests on Travis.
60
60
61
-
* The Flutter [release process](https://github.com/flutter/flutter/wiki/Release-process#rolling-the-beta-channel) didn’t call out the need to build and run the gallery as part of the beta vetting process, which further allowed the previous issue to go unnoticed.
61
+
* The Flutter [release process](../releases/Release-process.md#rolling-the-beta-channel) didn’t call out the need to build and run the gallery as part of the beta vetting process, which further allowed the previous issue to go unnoticed.
62
62
63
63
* The Flutter team didn’t have on its radar to mark builds as bad when they saw or fixed issues that would warrant marking a build as bad. It’d be nice to have a better (ideally more automated) process around this.
64
64
@@ -78,7 +78,7 @@ Description: Flutter launched beta 1 on February 27, 2018. This document attemp
78
78
79
79
### Bugs That Got in the Way
80
80
81
-
* In the “channel” command, we weren’t fetching updated refs from GitHub before [checking out the branch](https://github.com/flutter/flutter/blob/eaa9b47a4ac278a9439468911d2c361a472b114b/packages/flutter_tools/lib/src/commands/channel.dart#L103). This meant that if a user had switched to the beta branch in the past, then switched back to the alpha/dev branch as their primary channel, their beta Git head would be pointing to a commit in December. Net result: we had to [recommend](https://github.com/flutter/flutter/wiki/Flutter-build-release-channels#how-to-change-channels) that users run `flutter channel beta && flutter upgrade`, which is clunky.
81
+
* In the “channel” command, we weren’t fetching updated refs from GitHub before [checking out the branch](https://github.com/flutter/flutter/blob/eaa9b47a4ac278a9439468911d2c361a472b114b/packages/flutter_tools/lib/src/commands/channel.dart#L103). This meant that if a user had switched to the beta branch in the past, then switched back to the alpha/dev branch as their primary channel, their beta Git head would be pointing to a commit in December. Net result: we had to [recommend](../releases/Flutter-build-release-channels.md#how-to-change-channels) that users run `flutter channel beta && flutter upgrade`, which is clunky.
82
82
83
83
* Until Feb 7 ([#14507](https://github.com/flutter/flutter/pull/14507)), we had a bug in the channel switching logic that would create branches as local (non-tracking) branches. If users tried to upgrade such channels, they’d get an error message about “no upstream repository configured.” Users who had tried switching to the beta channel that we had quietly pushed in December 2017 were bitten by this and found their local Git repository in a bad state. This likely only affected a very small number of users (perhaps only members of the Flutter team), but [@timsneath](https://github.com/timsneath) was one such user, and it took some time to remotely diagnose what was going on with his setup and whether his problems were indicative of a larger issue that was going to affect a large subset of our users. This time added uncertainty to our launch during crunch-time, where we weren’t sure if we should call off the launch announcements.
84
84
@@ -107,12 +107,12 @@ Description: Flutter launched beta 1 on February 27, 2018. This document attemp
107
107
108
108
| Action Item | Owner | Issue | Notes |
109
109
|-------------|-------|-------|-------|
110
-
| Add a wiki page on identifying bad builds |[@tvolkert](https://github.com/tvolkert)| |[Done](https://github.com/flutter/flutter/wiki/Bad-Build-Identification)|
110
+
| Add a wiki page on identifying bad builds |[@tvolkert](https://github.com/tvolkert)| |[Done](../releases/Bad-Builds.md)|
111
111
| Send an email to the core Flutter team about the need to think about marking builds as bad. |[@tvolkert](https://github.com/tvolkert)|| Done |
112
-
| Update our release process to call out the need to ensure that the gallery can be built and run. |[@tvolkert](https://github.com/tvolkert)||[Done](https://github.com/flutter/flutter/wiki/Release-process#rolling-the-beta-channel)|
113
-
| Update release process to require that the Travis build go green on the beta branch before sending out any announcements or issuing any public communications. |[@tvolkert](https://github.com/tvolkert)||[Done](https://github.com/flutter/flutter/wiki/Release-process#rolling-the-beta-channel)|
114
-
| Make a beta pusher group in GitHub, to control who has access to push beta releases. |[@Hixie](https://github.com/Hixie)||[Done](https://github.com/flutter/flutter/wiki/Release-process#rolling-the-beta-channel)|
115
-
| Update beta release process to require that the candidate dev build “can be successfully upgraded to from the dev build to which the beta branch currently points.” |[@tvolkert](https://github.com/tvolkert)||[Done](https://github.com/flutter/flutter/wiki/Release-process#rolling-the-beta-channel)|
112
+
| Update our release process to call out the need to ensure that the gallery can be built and run. |[@tvolkert](https://github.com/tvolkert)||[Done](../releases/Release-process.md#rolling-the-beta-channel)|
113
+
| Update release process to require that the Travis build go green on the beta branch before sending out any announcements or issuing any public communications. |[@tvolkert](https://github.com/tvolkert)||[Done](../releases/Release-process.md#rolling-the-beta-channel)|
114
+
| Make a beta pusher group in GitHub, to control who has access to push beta releases. |[@Hixie](https://github.com/Hixie)||[Done](../releases/Release-process.md#rolling-the-beta-channel)|
115
+
| Update beta release process to require that the candidate dev build “can be successfully upgraded to from the dev build to which the beta branch currently points.” |[@tvolkert](https://github.com/tvolkert)||[Done](../releases/Release-process.md#rolling-the-beta-channel)|
116
116
| Update the release process to include downloading and installing the packaged archive for the dev build that represents the prior beta — and ensuring that it’s able to upgrade to the newest release. |[@gspen...](https://github.com/gspencergoog)|||
Copy file name to clipboardExpand all lines: docs/postmortems/Postmortem-Widespread-Gradle-failures-on-Flutter-v1.12.13-hotfix.5.md
+1-3Lines changed: 1 addition & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,3 @@
1
-
This document is published in our wiki on: https://github.com/flutter/flutter/wiki/Postmortem:-Widespread-Gradle-failures-on-Flutter-v1.12.13-hotfix.5
2
-
3
1
# Flutter postmortem: Widespread Gradle failures on Flutter v1.12.13+hotfix.5
4
2
5
3
Status: final<br>
@@ -19,7 +17,7 @@ User impact: Users of the following plugins: url_launcher, google_sign_in, video
19
17
stuartmorgan@ notices that Flutter applications that are using non-Android plugins are failing to build for Android (same for iOS) and files https://github.com/flutter/flutter/issues/39657. The root cause is that the Flutter gradle plugin assumes that all plugins include an Android implementation and tries to build it.
20
18
21
19
### 2019-09-16
22
-
stuargmorgan@ prototypes [a fix](https://github.com/flutter/flutter/compare/master...stuartmorgan:wip-platform-plugin-files?expand=1). That fix requires migration of existing plugins.
20
+
stuargmorgan@ prototypes [a fix](https://github.com/flutter/flutter/compare/main...stuartmorgan:wip-platform-plugin-files?expand=1). That fix requires migration of existing plugins.
23
21
24
22
### 2019-09-18
25
23
As a temporary workaround for the issue above (Android only), amirh@ lands https://github.com/flutter/flutter/pull/40640 which makes `flutter.gradle` skip packages that do not have an `android/build.gradle` file, this workaround lives in the Flutter SDK and does not require plugin migration.
Copy file name to clipboardExpand all lines: docs/postmortems/Retrospective-Flutter-2.8-Stable-Release.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -64,7 +64,7 @@ Xcode/Mac/iOS were force updated in between the beta to stable time window
64
64
*~6 days
65
65
* Create a solid release playbook on the wiki to be followed.
66
66
* Should be clear enough that two interns (meaning, two inexperienced people new to the team who have the appropriate permissions) should be able to make a release without supervision while everyone else is on vacation. (It has to be two because you need two people to authorize a release).
67
-
*https://github.com/flutter/flutter/wiki/Release-process should be (or point to) that process doc; other pages on the wiki should be up to date also.
67
+
*[Release Process](../releases/Release-process.md) should be (or point to) that process doc; other pages on the wiki should be up to date also.
68
68
* Align beta and stable release processes.
69
69
* Practice release dry runs.
70
70
* Have people who have never followed the steps before practice the steps, to find where the documentation is missing important details.
0 commit comments