Skip to content

docs(rfc): add RFC-000.001 Flutter Architecture & Reference Taxonomy - #1

Open
jtmcdole wants to merge 2 commits into
mainfrom
rfc000.001
Open

docs(rfc): add RFC-000.001 Flutter Architecture & Reference Taxonomy#1
jtmcdole wants to merge 2 commits into
mainfrom
rfc000.001

Conversation

@jtmcdole

@jtmcdole jtmcdole commented Aug 27, 2026

Copy link
Copy Markdown
Member

Establish the architecture taxonomy, numbering scheme, and lifecycle process for Flutter Requests for Comments (RFCs).

  • Introduce structured identifier format AAA.NNN across 8 core domains (000 Meta through 700 Documentation & Ecosystem).
  • Define file naming (rfc/AAA.NNN-kebab-case.md) and YAML frontmatter schema.
  • Outline a 4-step assignment lifecycle using .000 draft placeholders to prevent number collisions during proposal phases.
  • Specify rules for cross-cutting proposals and number immutability.
  • Uses OKF document headers for later adoption.

fixes: #2

Establish the architecture taxonomy, numbering scheme, and lifecycle process
for Flutter Requests for Comments (RFCs).

- Introduce structured identifier format `RFC-AAA.NNN` across 8 core domains
  (000 Meta through 700 Documentation & Ecosystem).
- Define file naming (`rfc/AAA.NNN-kebab-case.md`) and YAML frontmatter schema.
- Outline a 4-step assignment lifecycle using `.000` draft placeholders to
  prevent number collisions during proposal phases.
- Specify rules for cross-cutting proposals and number immutability.
@jtmcdole
jtmcdole requested review from Piinks and zanderso August 27, 2026 23:04
@jtmcdole

Copy link
Copy Markdown
Member Author

Would be nice to have "WANT_LGTM: <list|all>"

@jtmcdole

Copy link
Copy Markdown
Member Author

We should also consider OKF if we ever wanted to hook these up to a harness.

@zanderso zanderso left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

This is a great start. For a complete RFC process we'll also need RFCs that specify the review process, similar to what Slava has in his CL.

Comment thread rfc/000.001-flutter-architecture-and-reference-taxonomy.md Outdated
Comment thread rfc/000.001-flutter-architecture-and-reference-taxonomy.md Outdated
Comment thread rfc/000.001-flutter-architecture-and-reference-taxonomy.md Outdated
@jtmcdole

jtmcdole commented Aug 28, 2026

Copy link
Copy Markdown
Member Author

This is a great start. For a complete RFC process we'll also need RFCs that specify the review process, similar to what Slava has in his CL.

I welcome another RFC after this one, appropriately numbered, to cover the review process. Issue #3

@jtmcdole
jtmcdole requested a review from zanderso August 28, 2026 15:56
@jtmcdole

Copy link
Copy Markdown
Member Author

#4 added for @zanderso

- 000-meta
- 600-infrastructure
authors:
- codefu@google.com

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Maybe discourage use of email. Prefer Github username instead?

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'm OK with either. How strong is "discourage"?

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Pretty strong. Not sure folks want to put their contact info out there to get spammed with, or even worse, potential harrassment.

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 can make that a clear line in the rfc. As someone from Google, I'm OK with my email and name being here, and I'm totally ok with someone leaving a link to their github profile instead.

- If the proposal spans multiple areas, the shepherd helps identify the **primary** subsystem and ensures secondary areas are listed under `tags:` in frontmatter.

### Step 3: Sequential Number Allocation
- When the RFC enters the **Final Comment Period (FCP)** or is approved for merge:

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I think we need more structure around this - when is it in FCP? When does that happen? For how long, who manages it, etc.
...but I am about to go look at the second PR. Hold that thought.

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.

FCP is optional and the Shepard chooses it (or maybe the Forum). Happy to add more, but here we're just saying "When this gets done and before it lands, that's when you number it".

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

SGTM! Read PR 2, makes sense!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define RFC number allocation and taxonomy

3 participants