From fcd332f679724436297577ea4a66fececb3290dd Mon Sep 17 00:00:00 2001 From: "thomas.ekstrand" Date: Sun, 18 Feb 2024 18:09:23 -0600 Subject: [PATCH] First attempt at an RFC process --- .DS_Store | Bin 0 -> 6148 bytes CONTRIBUTION.md | 23 ++++++++++++++++ README.md | 72 ++++++++++++++++++++++++++++++++---------------- 3 files changed, 72 insertions(+), 23 deletions(-) create mode 100644 .DS_Store create mode 100644 CONTRIBUTION.md diff --git a/.DS_Store b/.DS_Store new file mode 100644 index 0000000000000000000000000000000000000000..aace8a28b1278e2cb5a5c03063ec7185190b5a88 GIT binary patch literal 6148 zcmeHKy-ve05WXvs2tPwdMn3^kHpWne9jPyX(yBkGQ7WJ-%EHDQF){E&h@J23qr@a- ztPr}B&YyEX_W4U>$3(=V%`_t#5>W~j92}wP5%G(5WT2K)Aj=r5c{ZNZ)w&aDhQG>y zyt{}zpH59imq&55)r>egz*&P+tLsz!>;f3~*A6ixHNjXKQD1a@IQN4OB$pnt **Note:** If you followed the steps to edit your proposal in the GitHub web interface, you can skip this step! Your proposal is already submitted as a PR. + +1. **Participate in the Discussion**: Engage with the community and project maintainers in the PR discussion. This is where your proposal will be reviewed, and feedback will be provided. + +1. **Finalizing the RFC**: The discussion period will remain open until the RFC is deemed complete. Upon completion, the PR will be closed. Note that closing the PR does not necessarily mean the RFC is approved; it signifies the end of the discussion phase. diff --git a/README.md b/README.md index b3ddb76..51d3869 100644 --- a/README.md +++ b/README.md @@ -1,50 +1,76 @@ # Meshtastic RFC Repository -Welcome to the RFC (Request for Comments) repository for the Meshtastic mesh networking project! This repository is a dedicated space for discussing and managing significant changes and enhancements to the Meshtastic project, which focuses on creating firmware for LoRa mesh networking radios. +Welcome to the RFC (Request for Comments) Documentation Repository. This repository is designed to increase community collaboration and ensure transparency throughout the development of Meshtastic. By following a structured approach to proposing, discussing, and implementing new features and changes, we seek to create a cohesive, forward-thinking community. ## Purpose of This Repository -The Meshtastic RFC repository serves as a centralized hub for collaboratively discussing, reviewing, and deciding on major changes and new features across various Meshtastic repositories. This includes the firmware repository, client applications, and language support repos. It's important to note that this repository is for documentation and discussion only and does not contain code files. +1. **Facilitate Open Communication**: Provide a place for contributors and community members to propose, discuss, and refine new ideas or changes to Meshtastic in an open and inclusive manner. +1. **Ensure Transparency**: Make the decision-making process visible to all stakeholders, allowing for a transparent and democratic approach to Meshtastic development. +1. **Promote Collaboration**: Encourage contributions to leverage the collective expertise and perspectives of our community to drive Meshtastic forward. +1. **Maintain Project Integrity**: Ensure that changes and new features align with Meshtastic's overall goals and values, while preserving integrity and focus. -## How to Make an RFC +## Contribution Guidelines & Participation -1. **Familiarize with the RFC Template**: Before submitting an RFC, please review our [RFC Template](template.md). This template provides a structured format for proposing changes. +While contributing to the Meshtastic RFC repository, please adhere to our community standards and guidelines. These are in place to ensure a productive and respectful environment for collaboration. -1. **Write up your proposal**: There are two methods to write up your proposal within this repository. If you are comfortable with how to work with Git, we recommend you clone this repository, create a copy of the RFC template in the `/rfcs` directory, and submit a PR. If you are not familiar with Git, we recommend you follow the steps below: +- Be respectful and constructive in your communication. +- Clearly articulate your proposals and feedback. +- Engage in discussions with an open mind. +- **Informal Discussions**: Before submitting an RFC, you may want to discuss your idea informally. Join us on our [Discord](https://discord.com/invite/ktMAKGBnBs) for preliminary discussions and feedback from the community. - 1. Sign into or create a GitHub account. Then, navigate to [https://github.com/meshtastic/rfcs](https://github.com/meshtastic/rfcs). +## Applicability - 1. Navigate to the RFC template in the root of the repository. Copy the contents of the template to your clipboard. +### When an RFC is Required - 1. Navigate to the `/rfcs` directory within this repository on GitHub. Click the `Add file` button and select `Create new file`. Name this file `YYYY-MM-DD-feature-name.md`, replacing `YYYY-MM-DD` with the current date and `feature-name` with a descriptive name for your proposal. Paste the contents of the template into this file. +An RFC is required for any significant change to Meshtastic, introduces new features, or has the potential to impact the user experience or ecosystem broadly. This includes, but is not limited to: - 1. Fill in the template with your proposal. Be sure to include a descriptive title and summary, as well as a detailed description of your proposal. Once you are done, copy the title and high-level description of your proposal. You will need this in the next step. +- Changes to the core architecture +- Introduction of new dependencies +- Major UI/UX changes +- Changes affecting backward compatibility +- Significant performance optimizations - 1. When you are finished, click "Commit Changes" at the top of the page. Enter the title and description from the last step into the appropriate fields. Then, click "Propose changes." This will create a new Pull Request (PR) for your proposal. +### When an RFC is _Encouraged_ - 1. Congratulations! You have successfully submitted an RFC. Now, you can engage in the discussion about your proposal. You can view your PR by navigating to the pull requests tab here: [https://github.com/meshtastic/rfcs/pulls](https://github.com/meshtastic/rfcs/pulls) +An RFC is encouraged for any initiative where someone or a group of someones wishes to benefit from the collective wisdom and experience of the Meshtastic community, but are **not subject to the rules below**. -1. **Submit Your RFC as a PR**: Create your RFC using the template and submit it as a Pull Request (PR) to this repository. Use the `Summary` section of your RFC as the PR description. Your PR will serve as the primary platform for discussion about your proposal. +### When an RFC is Not Required - > **Note:** If you followed the steps to edit your proposal in the GitHub web interface, you can skip this step! Your proposal is already submitted as a PR. +Minor changes that do not broadly impact the project's functionality or user experience may not require an RFC. This includes: -1. **Participate in the Discussion**: Engage with the community and project maintainers in the PR discussion. This is where your proposal will be reviewed, and feedback will be provided. +- Bug fixes +- Minor feature changes that do not alter key functionality +- Minor UI/UX adjustments that do not alter the overall design +- Documentation updates -1. **Finalizing the RFC**: The discussion period will remain open until the RFC is deemed complete. Upon completion, the PR will be closed. Note that closing the PR does not necessarily mean the RFC is approved; it signifies the end of the discussion phase. +## Timeline -## Community Participation +The typical timeline for an RFC process, which is a minimum of 3 weeks, is as follows: -We highly encourage community involvement in the RFC process. Whether you're proposing an RFC or contributing to the discussion of someone else's, your input is valuable. +1. **Proposal Submission**: The RFC is submitted to the repository and made available for public comment. +1. **Discussion Period**: A minimum of 2 weeks is allocated for community discussion and feedback. This period may be extended based on the complexity of the RFC or the volume of feedback received. +1. **Revision Period**: (optional) Up to 1 week for the proposer to incorporate feedback and make necessary revisions to the RFC. +1. **Final Decision**: Within 1 week after the revision period or discussion period, a decision will be made regarding the RFC's implementation. -- **Informal Discussions**: Before submitting an RFC, you may want to discuss your idea informally. Join us on our [Discord](https://discord.com/invite/ktMAKGBnBs) for preliminary discussions and feedback from the community. +## Decision Making +### Handling Open Questions -## Contribution Guidelines +If open questions remain as the discussion timeline concludes: -While contributing to the Meshtastic RFC repository, please adhere to our community standards and guidelines. These are in place to ensure a productive and respectful environment for collaboration. +- The RFC proposer, in collaboration with core contributors, will assess whether additional information or revisions are needed to address these questions. +- If consensus cannot be reached within the allotted time, the decision will be escalated to the Meshtastic administrators for review. -- Be respectful and constructive in your communication. -- Clearly articulate your proposals and feedback. -- Engage in discussions with an open mind. +### Approval Process + +For an RFC to be merged and accepted: + +1. **Consensus Among Core Contributors**: There must be approval by _at least_ one core contributor from each project/repository that will be impacted by the RFC during the 1 week **Final Decision** period. + - **Core Contributor**: A core contributor is someone who + - At the end of the period, if there are no "Request Changes" from a core contributor the RFC will be accepted/merged. +1. **Changes Requested**: In the case that changes are requested by a core contributor and a consensus cannot be reached, the decision will be escalated to the Meshtastic administrators for a majority rule final vote. + +## How to Make an RFC +Please refer to the [CONTRIBUTION.md](CONTRIBUTION.md) file for detailed instructions on how to submit an RFC. ## Questions and Contact