How to propose changes with RFCs

This post goes over how to propose changes with RFCs (Request for Comments).


Request for Comments (RFC) is a useful tool for proposing, sharing, and discussing a change you’d like to make.


  • Convey a problem or change.
  • Get buy-in from stakeholders for a proposal.
  • Document the reasons for a decision.

RFCs can be:

  • A process update.
  • A technical change.
  • A decision on a vendor.
  • Anything you want feedback on.

RFC Template

  • Date: 20XX-XX-XX
  • Author: Your Name


1-2 sentences that describes your RFC in a high-level.

Type Rating
Impact High/Medium/Low
Effort High/Medium/Low
Risk High/Medium/Low

What Problem Are We Solving?

Why are we doing this?

What are the pain points?

What use cases does it support?

What is the expected outcome?

How Could We Solve It?

This is the bulk of the RFC so explain your options in as much detail as appropriate.

Try to give each option a fair consideration.


Who are the reviewers/stakeholders who can approve this RFC?

If it’s your supervisor, please reach out to them first.


What option do you think is best?

What alternatives were considered and what were the reasons for not choosing them?

Areas of Risk

Why should we not do this?

If there are tradeoffs to choosing an approach, please identify them there.

What is the impact on users (external/internal)?

Open Questions

Remaining questions to be answered before the implementation.

Definition of Done

What is required for the RFC to be closed?

Please support this site and join our Discord!