This repository contains Requests for Comments (RFCs) for proposed Open Modeling Foundation (OMF) standards, governance changes, and other significant community decisions.
RFCs provide an open, transparent process for discussing ideas before they become official OMF standards. All discussion, revisions, and decision history are preserved in Git to provide a permanent public record.
An RFC is appropriate for changes that have broad impact, including:
- New OMF standards
- Major revisions to existing standards
- Changes to governance or community processes
- Other proposals that benefit from public review and long-term documentation
Small editorial fixes and clarifications should be made directly to the relevant documents and generally do not require an RFC. If you're unsure which category a change falls into, open a GitHub Discussion — that's what step 1 below is for.
-
Discuss the idea Before writing an RFC, start a GitHub Discussion or issue to gather early feedback and determine whether the proposal is worth pursuing. This step is optional but strongly encouraged — it surfaces prior art and objections before you've invested time in a full draft.
-
Write the RFC Copy
template.mdto a new file and describe the motivation, proposed specification, rationale, alternatives considered, and any open questions. Name the fileNNNN-short-descriptive-title.md, using0000as a placeholder for the RFC number (see Repository Structure for how the real number gets assigned). -
Open a Pull Request Submit the RFC as a pull request against this repository. Community discussion and revisions take place in the PR and any linked GitHub Discussions. Once the PR is opened, a maintainer will assign the RFC its permanent number and you can rename the file accordingly.
-
Community Review There's no fixed review period. Maintainers will allow sufficient time for community feedback before making a decision, taking into account the scope and impact of the proposal.
-
Decision Maintainers will determine whether the RFC is:
- Accepted: The proposal is approved and merged.
- Rejected: The proposal is closed with rationale.
- Deferred: The proposal has merit but is not actionable right now; it may be revisited in the future.
- Superseded: Replaced by a later accepted RFC.
-
Implementation Accepted RFCs provide the design basis for OMF standards, governance changes, or other Foundation initiatives. The resulting standard or implementation may evolve during development, but any substantive changes should be proposed through a new RFC.
Idea
↓
Discussion (optional)
↓
Draft RFC
↓
Pull Request → Public Review
↓
Accepted / Rejected / Deferred
↓
Implementation
rfcs/
├── README.md
├── template.md
├── text/
│ ├── 0001-model-documentation-standard.md
│ └── ...
└── assets/
RFC numbers are assigned sequentially by a maintainer at PR-open time and remain permanent, regardless of whether an RFC is accepted or rejected. Each RFC file should begin with a short metadata block:
Number:
Title:
Status:
Author:
Created:
Discussion:
Supersedes: (optional)
Superseded-By: (optional)
The RFC process aims to be:
- Open — Anyone may propose ideas and participate in discussion.
- Transparent — All proposals, reviews, and decisions are public.
- Collaborative — Decisions are made by maintainers after considering community feedback. Consensus is preferred over voting whenever practical.
- Documented — Decisions and their rationale are preserved for future contributors.
- Lightweight — The process should encourage participation rather than create unnecessary bureaucracy.
Our goal is to build high quality, community-driven standards through open discussion and thoughtful iteration.
If you're not sure whether your idea needs an RFC, or you're stuck on process, open a Discussion or issue.