Welcome to the AlmaLinux Engineering Steering Committee's (ALESCo) RFC repository. This repository is the central place for proposing, discussing, and documenting significant changes to AlmaLinux.
- Introduction
- When to Submit an RFC
- RFC Process Overview
- How to Submit an RFC
- RFC Lifecycle
- RFC Template
- Contributing Guidelines
- License
- Contact
- Additional Notes
- Frequently Asked Questions
The AlmaLinux RFC process is a formal way to propose significant changes, enhancements, or new features to the AlmaLinux project. It aims to foster open collaboration, transparency, and comprehensive documentation of decisions made by ALESCo and the broader community.
Consider submitting an RFC if you are proposing:
- Major changes to the operating system or its components.
- EX, Changing the default desktop environment
- New features or functionalities.
- EX, Adding SPICE support
- Any change that requires community consensus or impacts a large portion of the project.
- EX, Replacing the use of OpenSSL with LibreSSL
For minor issues like bug fixes or small enhancements, please use the appropriate AlmaLinux issue tracker or contribute directly to the relevant repository.
- Proposal Drafting: Author drafts the RFC using the provided template.
- Submission: RFC is submitted as a pull request to this repository.
- Public Discussion: Community and ALESCo members provide feedback.
- Review Period: A designated period for discussion and revisions.
- Final Comment Period (FCP): A last call for comments before the decision.
- Decision Making: ALESCo reviews and votes on the RFC.
- Implementation: Accepted RFCs are merged and scheduled for implementation.
- Fork the Repository: Click the "Fork" button at the top-right corner of this page to create your own copy of the repository.
- Create a New Branch: In your forked repository, create a new branch for your RFC:
git checkout -b rfc-title-of-your-proposal
- Copy the Template: Copy the
0000-template.md
torfcs/XXXX-title-of-your-proposal.md
, replacingXXXX
with the next available RFC number (use0000
for the initial PR; the number will be assigned during the process). - Write the RFC: Fill out the template with your proposal. Be thorough and clear.
- Submit a Pull Request: Push your branch to your fork and submit a pull request to this repository's main branch.
- Engage in Discussion: Monitor the pull request comments and participate in the discussion, making revisions as necessary.
The RFC process has the following states:
- Draft: The RFC is under initial discussion and may undergo several revisions.
- FCP (Final Comment Period): ALESCo announces an FCP, signaling that the decision will be made soon.
- Accepted: The RFC is approved and merged.
- Rejected: The RFC is not approved; reasons are documented.
- Withdrawn: The RFC is withdrawn by the author.
- Superseded: The RFC is replaced by a new proposal.
The RFC template can be found here. Please use this template for all new RFCs.
- Clarity: Write clear and concise proposals.
- Respect: Be respectful in discussions; adhere to the Code of Conduct.
- Responsiveness: Be available to answer questions and provide clarifications during the review process.
- Documentation: Update your RFC based on feedback received.
All participants are expected to uphold the AlmaLinux Code of Conduct.
Which amounts to: be nice, be respectful, and be nerdy.
By contributing to this repository, you agree that your contributions will be licensed under the Creative Commons Attribution Share Alike 4.0 International (CC-BY-SA-4.0`).
- Mailing List: [email protected]
- Forums: AlmaLinux Community Forums
- Chat: AlmaLinux MatterMost
- Assigning RFC Numbers: RFC numbers are assigned by the repository maintainers when the pull request is labeled as "Ready for Review." Use 0000 as the number in your initial submission.
- File Naming Convention: Name your RFC file as XXXX-title-of-your-proposal.md, where XXXX is the assigned RFC number.
- Directory Structure: All RFC files should be placed in the rfcs/ directory.
- Updating RFC Status: The status of the RFC should be updated in the document header as it progresses through the lifecycle stages.
The standard review period is two weeks, but it can be extended if necessary to ensure adequate discussion.
The final decision is made by ALESCo, taking into account community feedback and the overall impact on the project. There is no obligation for the RFC to be accepted by the committee.
It is expected that contributors will be responsible for all or part of the work implementing the RFC.
Yes, you can withdraw your RFC at any point before it is accepted by closing the pull request and stating your intention.