Skip to content

Contributing RFCs

RFC Template

All RFCs should follow this structure:

# RFC-XXX: Title

**Version:** X.Y
**Status:** Draft | Review | Approved | Superseded
**Authors:** @handle
**Created:** YYYY-MM-DD
**Updated:** YYYY-MM-DD

## Summary

One paragraph explaining the proposal.

## Motivation

Why are we doing this? What problem does it solve?

## Design

Technical details of the proposal.

## Alternatives Considered

What other approaches were evaluated?

## Open Questions

Unresolved issues for discussion.

Process

  1. Fork the repo
  2. Create rfcs/XXX-short-name.md using the template
  3. Open a PR with [RFC] prefix in the title
  4. Address feedback in the PR discussion
  5. Once approved, the RFC is merged

Status Definitions

  • Draft: Initial proposal, not yet ready for review
  • Review: Open for comments
  • Approved: Accepted and merged
  • Superseded: Replaced by a newer RFC (link provided)