How grpc/proposal works
Project Type and Purpose
• This is an open-source documentation repository that holds the gRPC RFCs (design proposals) for the gRPC ecosystem.
• Its primary purpose is to collect, version, and govern design proposals (RFCs) across all gRPC languages and core.
Main Components
a. GitHub Repository (“grpc/grpc-rfcs”)
• Contains all markdown files for proposals, grouped by prefix (A*, P*, L*, G*).
• Holds governance docs (GOVERNANCE.md, CONTRIBUTING.md), templates (GRFC-TEMPLATE.md), and process documentation (README.md).
b. Proposal Files
• A-prefixed: cross-language design proposals (e.g., A1-http-connect-proxy-support.md)
• L-prefixed: language-specific external API changes (e.g., L102-core-move-insecure-creds-declaration.md)
• G-prefixed: protocol-level changes (e.g., G2-http3-protocol.md)
• P-prefixed: process proposals (e.g., P1-cloud-native.md)
c. Contribution Workflow
• Fork & branch on GitHub → Copy & rename GRFC-TEMPLATE.md → Draft RFC → Open PR → Assign APPROVER → Start discussion on grpc-io mailing list → Iterate for 10+ business days → APPROVER finalizes → Merge.
d. External Services
• GitHub: pull request hosting, file versioning.
• grpc-io Google Group: design discussion and community feedback.
Architectural Patterns and Design Principles
• “Content as Code”: Markdown files under Git version control.
• Template-driven consistency: a single GRFC-TEMPLATE.md enforces uniform structure.
• Prefix-based categorization: file name conventions route files to the right area of concern (cross-language, language-specific, protocol, process).
• Clear governance boundaries: designated APPROVER role and formal state transitions (Draft → In Review → Final → Implemented).
Relationships and Data Flow
• Contributors clone/fork the repo → create new markdown RFC → submit PR to GitHub → triggered review by APPROVER → PR linked to grpc-io thread → community discussion → APPROVER merges final PR → new RFC appears in repo.
• Static repo content is consumed directly on GitHub or via any downstream documentation site integration (not in this repo).