Skip to content

Let's start the RFCs!#1

Open
TheElectronWill wants to merge 2 commits into
mainfrom
init-rfc-process
Open

Let's start the RFCs!#1
TheElectronWill wants to merge 2 commits into
mainfrom
init-rfc-process

Conversation

@TheElectronWill

@TheElectronWill TheElectronWill commented Jun 9, 2026

Copy link
Copy Markdown
Member

disclosure: Mistral has been used as a redaction assistant (I have used it for exploration and extensively edited its proposals)

Inspirations: Rust RFCs, OpenFGA RFCs, Juan Pablo Buritica's templates.

todo:

  • explain the RFC life cycle
  • choose a licence -> I suggest CC–BY-SA 4.0

@TheElectronWill TheElectronWill force-pushed the init-rfc-process branch 3 times, most recently from 55c0bd4 to efb7b26 Compare June 10, 2026 08:09
Comment thread README.md
### Draft Phase (optional)

1. Author opens a draft PR with the RFC (using the template – see [CONTRIBUTING.md](CONTRIBUTING.md)).
1. Early feedback from the community.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

IMO it's important, and should not be optional as some people can just propose idea and maybe others could get the same (be sure to check if the idea was not already proposed before). Early feedback can also help to steer the idea in the right direction

Comment thread README.md
Once no major concerns remain, Alumet contributors can approve the PR.
When everything is clear, a maintainer merges the PR.

Implementation begins, tracked via linked issues in the appropriate repository.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should it be a good idea to always link the RFC (of this repo) in futurs associated PRs (on alumet repo) ?

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think issues are enough since they're already linked to PRs

Comment thread CONTRIBUTING.md

**Discuss Your Idea First**.

- Discuss IRL, open a [GitHub Discussion](https://github.com/alumet-dev/alumet/discussions) or open an issue to gauge interest and gather early feedback.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What about a mailing list one day ?

Comment thread CONTRIBUTING.md

**Take your time** preparing the document.
The writing process itself will help you refine your ideas, explore alternative designs, and clarify your communication.
While you don't need to over-explain basic concepts, the RFC should be clear enough for any experienced contributor to understand.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can the schemes be encouraged if necessary?

Comment thread CONTRIBUTING.md
Comment on lines +15 to +18
Work on your idea, on your own or with others.
If possible, create a prototype of your solution.
Since the goal of the RFC is to work on the ideas and design, there is no need for a perfect implementation.
What you need to develop is a **deep understanding of the subject**.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just to be sure, are you aware that this will be rendered as a single line?

Comment thread CONTRIBUTING.md
- Use the title format: `RFC: [Short Descriptive Title]`.
- Use the PR template

2. **Update the RFC number** with the PR number.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So RFC1 will never exist? 😢

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we add a small checklist to ensure that basic steps have been completed?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants