Skip to content

docs: migrate design document guidance to flutter/rfc - #192648

Merged
jtmcdole merged 1 commit into
flutter:masterfrom
jtmcdole:updateRfcDocs
Sep 14, 2026
Merged

jtmcdole merged 1 commit into
flutter:masterfrom
jtmcdole:updateRfcDocs

Conversation

@jtmcdole

Copy link
Copy Markdown
Member

Update documentation across the repository, issue templates, and contribution guides to establish flutter/rfc as the authoritative workflow for Flutter RFCs and design documents:

  • Streamline docs/contributing/Design-Documents.md to focus on the RFC threshold, PR-based approvals, and source-code documentation.
  • Update .github/ISSUE_TEMPLATE/07_design_doc.yml to require flutter/rfc pull request links.
  • Update CONTRIBUTING.md, Tree-hygiene.md, Chat.md, and issue hygiene docs to point to flutter/rfc and clarify breaking change policies.
  • Remove obsolete references to flutter.dev/go/template and clarify fcontrib.org account history.

Update documentation across the repository, issue templates, and
contribution guides to establish flutter/rfc as the authoritative
workflow for Flutter RFCs and design documents:

- Streamline docs/contributing/Design-Documents.md to focus on the RFC
  threshold, PR-based approvals, and source-code documentation.
- Update .github/ISSUE_TEMPLATE/07_design_doc.yml to require flutter/rfc
  pull request links.
- Update CONTRIBUTING.md, Tree-hygiene.md, Chat.md, and issue hygiene
  docs to point to flutter/rfc and clarify breaking change policies.
- Remove obsolete references to flutter.dev/go/template and clarify
  fcontrib.org account history.
@jtmcdole
jtmcdole requested a review from Piinks September 11, 2026 20:19
@jtmcdole jtmcdole added the d: docs/ flutter/flutter/docs, for contributors label Sep 11, 2026
@flutter-dashboard flutter-dashboard Bot added the CICD Run CI/CD label Sep 11, 2026
@github-actions github-actions Bot added c: contributor-productivity Team-specific productivity, code health, technical debt. framework flutter/packages/flutter repository. See also f: labels. labels Sep 11, 2026

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think its best to click "..." and "View File" to see the output of this change.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the Flutter project's documentation, contributing guides, and issue templates to transition from the historical Google Docs-based design document process to the new GitHub-based Flutter RFC (Request for Comments) process hosted in the flutter/rfc repository. I have no feedback to provide as there are no review comments.

@jtmcdole
jtmcdole added this pull request to the merge queue Sep 14, 2026
Merged via the queue into flutter:master with commit 435cf9a Sep 14, 2026
28 checks passed
@jtmcdole
jtmcdole deleted the updateRfcDocs branch September 14, 2026 23:09
auto-submit Bot pushed a commit to flutter/packages that referenced this pull request Sep 16, 2026
flutter/flutter@8b3e8f5...27fec0e

2026-09-14 [email protected] Add dedicated rubber band spring for overscroll recovery in BouncingScrollPhysics (flutter/flutter#187568)
2026-09-14 [email protected] Roll Skia from 83c984a6daf5 to 59904977fcbb (8 revisions) (flutter/flutter#192767)
2026-09-14 [email protected] Request unbuffered dispatch for platform view motion events after `_PlatformViewGestureRecognizer` rejects gesture (flutter/flutter#192259)
2026-09-14 [email protected] Roll Fuchsia GN SDK from ZsxUUK2SfA-TrNvb8... to PDJz3b3CL31uoLOkD... (flutter/flutter#192440)
2026-09-14 [email protected] ci(bringup): cleanup some bringup (flutter/flutter#192752)
2026-09-14 [email protected] Warn users on potential removal of dart:html in dry run (flutter/flutter#192710)
2026-09-14 [email protected] docs: migrate design document guidance to flutter/rfc (flutter/flutter#192648)
2026-09-14 [email protected] Sync CHANGELOG.md from stable (flutter/flutter#192499)
2026-09-14 [email protected] Roll Skia from 7a6fd7ff72d5 to 83c984a6daf5 (1 revision) (flutter/flutter#192745)
2026-09-14 [email protected] RELAND: [devicelab] Clean up Chrome profile directories and trap abort signals in web benchmarks (flutter/flutter#192655)
2026-09-14 [email protected] fix(web): hide --web-content-hash until content hashing is complete (flutter/flutter#192663)
2026-09-14 [email protected] Roll Skia from 527751088719 to 7a6fd7ff72d5 (2 revisions) (flutter/flutter#192725)
2026-09-14 [email protected] Roll Skia from eaf9f82813eb to 527751088719 (1 revision) (flutter/flutter#192722)
2026-09-14 [email protected] Roll Fuchsia Linux SDK from AQu85JoTHCMET3Q8G... to 7R1l5MhSZZUr1Q6D1... (flutter/flutter#192719)
2026-09-14 [email protected] [Linux] Clear the frame when there is nothing to render (flutter/flutter#192461)

If this roll has caused a breakage, revert this CL and set the roller
to dry run mode using the controls here:
https://autoroll.skia.org/r/flutter-packages
Please CC [email protected],[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
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

c: contributor-productivity Team-specific productivity, code health, technical debt. CICD Run CI/CD d: docs/ flutter/flutter/docs, for contributors framework flutter/packages/flutter repository. See also f: labels.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants