RFC Controversy Outline
An RFC skeleton covering the proposal, known risks, and open questions for a technically controversial change.
More from Writing
What you get
A precise RFC skeleton document in a format suitable for engineering teams, covering proposal, risks, and open questions, delivered as a text output.
Who it's for
- Engineering team leads proposing technical changes
- Software architects assessing trade-offs
- DevOps engineers evaluating migration paths
- Technical writers documenting system updates
- Product managers mitigating implementation risks
Use cases
- Proposing a technically controversial change to internal APIs
- Assessing the risks of replacing REST with GraphQL
- Documenting the trade-offs of a system migration
- Evaluating the feasibility of a new technical approach
- Mitigating the risks of a proposed technical change
- Creating a balanced technical proposal for stakeholders
FAQ
what should an rfc proposal include
An RFC proposal should include a clear summary, motivation, proposal details, known risks and mitigations, alternatives considered, and open questions. The document should be precise, blameless, and neutral, focusing on trade-offs rather than advocacy.
how do i structure an rfc document
A typical RFC document structure includes sections for Summary, Motivation, Proposal, Risks & Mitigations, Alternatives Considered, and Open Questions. This structure helps ensure that all necessary aspects of the proposal are addressed in a clear and organized manner.
what are some common risks in technical proposals
Common risks in technical proposals include team experience gaps, client caching behavior differences, and the need for additional governance or infrastructure. Identifying and addressing these risks is crucial for a successful proposal.
how long should an rfc proposal be
The length of an RFC proposal can vary, but it should be concise and to the point, focusing on the essential information and trade-offs. A well-structured proposal with clear sections can effectively communicate the necessary details without being overly lengthy.
Last updated: 2026-06-28