Standardize review timeline guidance#183465
Conversation
Currently on the same page we say to ping people: - After two weeks (in When) (and the tl;dr). - After one week (in Who). - Immediately, in step 7 of the PR process overview. This makes it hard for new contributors to understand what the actual expectation is, and in practice the step 7 version creates behavior we don't want (immediately pinging people, usually the wrong ones, instead of waiting for the normal triage process). This standardizes everything on two weeks.
There was a problem hiding this comment.
Code Review
This pull request standardizes the review timeline guidance in docs/contributing/Tree-hygiene.md to two weeks, resolving inconsistencies across the document. The changes align the instructions for when to ping for a review. I've found a minor typo in the updated text that should be corrected.
Note: Security Review has been skipped due to the limited scope of the PR.
| that's probably a good place to start. | ||
| 7. Get your code reviewed (see below). If you are a team member, request review | ||
| from the relevant expert(s) for the areas you touched. Otherwise, wait for | ||
| [reviewers to be assigned](#who). |
There was a problem hiding this comment.
I noticed something strange under #who about material and cupertino PRs not being assigned. Which is weird. I've asked around if anyone recalls why. I can put up a PR to remove it, unless you want to add it to this PR?
There was a problem hiding this comment.
I've asked around if anyone recalls why.
Ian added it on August 14th, 2023. Discord spelunking turned up this discussion. The key part is this comment from Hans:
Most Material (and Cupertino) and framework contributions from the community are assigned a reviewer within a week and should get the reviewer's attention as needed. It's assumed that engineers on Flutter team who need reviewers will advocate for themselves
If that's outdated I can remove it here.
There was a problem hiding this comment.
Impressive! Thanks for finding that. I think it's outdated. Let's remove it.
There was a problem hiding this comment.
Done. I left this more general text here though, since I think having team members request review is still generally the right guidance.
flutter/flutter@3f400d7...9e36adb 2026-03-12 [email protected] Roll Fuchsia Linux SDK from QD887D4OanteB7UKM... to jJbpv4J_tjW-wuKDq... (flutter/flutter#183584) 2026-03-12 [email protected] Adding the SatelliteWindowController interface to `_window.dart` (flutter/flutter#182903) 2026-03-12 [email protected] Roll Skia from 0cab3e4ee34b to 46f41493ebf4 (17 revisions) (flutter/flutter#183553) 2026-03-12 [email protected] Roll Dart SDK from 8531f7c2bdae to 59be21f25f2d (4 revisions) (flutter/flutter#183547) 2026-03-12 [email protected] [ios][engine] Fix keyboard flicker when switching text fields (flutter/flutter#182661) 2026-03-11 [email protected] Rename hcpp opt in flag to `enable-hcpp` (flutter/flutter#183151) 2026-03-11 [email protected] Roll pub packages (flutter/flutter#183541) 2026-03-11 [email protected] Re-enable gpu_test.dart for opengles, but disable specific tests in the file (flutter/flutter#183531) 2026-03-11 [email protected] Use CLA-approved email and username for github workflow commits. (flutter/flutter#183540) 2026-03-11 [email protected] [integration_test]UIScene Migration (flutter/flutter#182631) 2026-03-11 [email protected] ci: Run orchestrator for windows_arm_host_engine on Linux (flutter/flutter#181075) 2026-03-11 [email protected] [web] Prevent Firefox auto-updates (flutter/flutter#183330) 2026-03-11 [email protected] Add scrollCacheExtent to PageView (flutter/flutter#180411) 2026-03-11 [email protected] Remove redundant VS Code code/tests (flutter/flutter#183506) 2026-03-11 [email protected] Roll pub packages (flutter/flutter#183527) 2026-03-11 [email protected] Reapply "Make HCPP upgrading work for vd/tlhc (#181024)" (#183310) (flutter/flutter#183360) 2026-03-11 [email protected] Add awaits to dev/ callsites (flutter/flutter#183479) 2026-03-11 [email protected] Standardize review timeline guidance (flutter/flutter#183465) 2026-03-11 [email protected] Rename ExecutionModelToString to ExecutionModelToStringName. (flutter/flutter#183461) 2026-03-11 [email protected] Fix input mirroring in platform views when system language is RTL, and support is set in manifest. (flutter/flutter#183472) 2026-03-11 [email protected] Roll Packages from ee460d6 to ecace66 (10 revisions) (flutter/flutter#183517) If this roll has caused a breakage, revert this CL and stop the roller using the controls here: https://autoroll.skia.org/r/flutter-packages Please CC [email protected] on the revert to ensure that a human is aware of the problem. To file a bug in Packages: https://github.com/flutter/flutter/issues/new/choose To report a problem with the AutoRoller itself, please file a bug: https://issues.skia.org/issues/new?component=1389291&template=1850622 Documentation for the AutoRoller is here: https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md
…r#11233) flutter/flutter@3f400d7...9e36adb 2026-03-12 [email protected] Roll Fuchsia Linux SDK from QD887D4OanteB7UKM... to jJbpv4J_tjW-wuKDq... (flutter/flutter#183584) 2026-03-12 [email protected] Adding the SatelliteWindowController interface to `_window.dart` (flutter/flutter#182903) 2026-03-12 [email protected] Roll Skia from 0cab3e4ee34b to 46f41493ebf4 (17 revisions) (flutter/flutter#183553) 2026-03-12 [email protected] Roll Dart SDK from 8531f7c2bdae to 59be21f25f2d (4 revisions) (flutter/flutter#183547) 2026-03-12 [email protected] [ios][engine] Fix keyboard flicker when switching text fields (flutter/flutter#182661) 2026-03-11 [email protected] Rename hcpp opt in flag to `enable-hcpp` (flutter/flutter#183151) 2026-03-11 [email protected] Roll pub packages (flutter/flutter#183541) 2026-03-11 [email protected] Re-enable gpu_test.dart for opengles, but disable specific tests in the file (flutter/flutter#183531) 2026-03-11 [email protected] Use CLA-approved email and username for github workflow commits. (flutter/flutter#183540) 2026-03-11 [email protected] [integration_test]UIScene Migration (flutter/flutter#182631) 2026-03-11 [email protected] ci: Run orchestrator for windows_arm_host_engine on Linux (flutter/flutter#181075) 2026-03-11 [email protected] [web] Prevent Firefox auto-updates (flutter/flutter#183330) 2026-03-11 [email protected] Add scrollCacheExtent to PageView (flutter/flutter#180411) 2026-03-11 [email protected] Remove redundant VS Code code/tests (flutter/flutter#183506) 2026-03-11 [email protected] Roll pub packages (flutter/flutter#183527) 2026-03-11 [email protected] Reapply "Make HCPP upgrading work for vd/tlhc (#181024)" (#183310) (flutter/flutter#183360) 2026-03-11 [email protected] Add awaits to dev/ callsites (flutter/flutter#183479) 2026-03-11 [email protected] Standardize review timeline guidance (flutter/flutter#183465) 2026-03-11 [email protected] Rename ExecutionModelToString to ExecutionModelToStringName. (flutter/flutter#183461) 2026-03-11 [email protected] Fix input mirroring in platform views when system language is RTL, and support is set in manifest. (flutter/flutter#183472) 2026-03-11 [email protected] Roll Packages from ee460d6 to ecace66 (10 revisions) (flutter/flutter#183517) If this roll has caused a breakage, revert this CL and stop the roller using the controls here: https://autoroll.skia.org/r/flutter-packages Please CC [email protected] on the revert to ensure that a human is aware of the problem. To file a bug in Packages: https://github.com/flutter/flutter/issues/new/choose To report a problem with the AutoRoller itself, please file a bug: https://issues.skia.org/issues/new?component=1389291&template=1850622 Documentation for the AutoRoller is here: https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md
Currently on the same page we say to ping people: - After two weeks (in When) (and the tl;dr). - After one week (in Who). - Immediately, in step 7 of the PR process overview. This makes it hard for new contributors to understand what the actual expectation is, and in practice the step 7 version creates behavior we don't want (immediately pinging people, usually the wrong ones, instead of waiting for the normal triage process). This standardizes everything on two weeks. --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
Currently on the same page we say to ping people: - After two weeks (in When) (and the tl;dr). - After one week (in Who). - Immediately, in step 7 of the PR process overview. This makes it hard for new contributors to understand what the actual expectation is, and in practice the step 7 version creates behavior we don't want (immediately pinging people, usually the wrong ones, instead of waiting for the normal triage process). This standardizes everything on two weeks. --------- Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
…r#11233) flutter/flutter@3f400d7...9e36adb 2026-03-12 [email protected] Roll Fuchsia Linux SDK from QD887D4OanteB7UKM... to jJbpv4J_tjW-wuKDq... (flutter/flutter#183584) 2026-03-12 [email protected] Adding the SatelliteWindowController interface to `_window.dart` (flutter/flutter#182903) 2026-03-12 [email protected] Roll Skia from 0cab3e4ee34b to 46f41493ebf4 (17 revisions) (flutter/flutter#183553) 2026-03-12 [email protected] Roll Dart SDK from 8531f7c2bdae to 59be21f25f2d (4 revisions) (flutter/flutter#183547) 2026-03-12 [email protected] [ios][engine] Fix keyboard flicker when switching text fields (flutter/flutter#182661) 2026-03-11 [email protected] Rename hcpp opt in flag to `enable-hcpp` (flutter/flutter#183151) 2026-03-11 [email protected] Roll pub packages (flutter/flutter#183541) 2026-03-11 [email protected] Re-enable gpu_test.dart for opengles, but disable specific tests in the file (flutter/flutter#183531) 2026-03-11 [email protected] Use CLA-approved email and username for github workflow commits. (flutter/flutter#183540) 2026-03-11 [email protected] [integration_test]UIScene Migration (flutter/flutter#182631) 2026-03-11 [email protected] ci: Run orchestrator for windows_arm_host_engine on Linux (flutter/flutter#181075) 2026-03-11 [email protected] [web] Prevent Firefox auto-updates (flutter/flutter#183330) 2026-03-11 [email protected] Add scrollCacheExtent to PageView (flutter/flutter#180411) 2026-03-11 [email protected] Remove redundant VS Code code/tests (flutter/flutter#183506) 2026-03-11 [email protected] Roll pub packages (flutter/flutter#183527) 2026-03-11 [email protected] Reapply "Make HCPP upgrading work for vd/tlhc (#181024)" (#183310) (flutter/flutter#183360) 2026-03-11 [email protected] Add awaits to dev/ callsites (flutter/flutter#183479) 2026-03-11 [email protected] Standardize review timeline guidance (flutter/flutter#183465) 2026-03-11 [email protected] Rename ExecutionModelToString to ExecutionModelToStringName. (flutter/flutter#183461) 2026-03-11 [email protected] Fix input mirroring in platform views when system language is RTL, and support is set in manifest. (flutter/flutter#183472) 2026-03-11 [email protected] Roll Packages from ee460d6 to ecace66 (10 revisions) (flutter/flutter#183517) If this roll has caused a breakage, revert this CL and stop the roller using the controls here: https://autoroll.skia.org/r/flutter-packages Please CC [email protected] on the revert to ensure that a human is aware of the problem. To file a bug in Packages: https://github.com/flutter/flutter/issues/new/choose To report a problem with the AutoRoller itself, please file a bug: https://issues.skia.org/issues/new?component=1389291&template=1850622 Documentation for the AutoRoller is here: https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md
Currently on the same page we say to ping people:
This makes it hard for new contributors to understand what the actual expectation is, and in practice the step 7 version creates behavior we don't want (immediately pinging people, usually the wrong ones, instead of waiting for the normal triage process).
This standardizes everything on two weeks.