RESO Change Proposal (RCP) Process
New Change Proposals
- Make a post on GitHub Discussions. This should contain a summary of the business case, list of requirements, and initial proposal.
- Request that the topic be added to the Transport Workgroup agenda by emailing firstname.lastname@example.org at least two weeks before the meeting in which it’s to be discussed. Ideally, there should be activity in the GitHub Discussion prior to the workgroup meeting.
- Once there’s consensus in the group to move a given item forward, Transport will send it to the Certification Subgroup. An issue should be created with a preliminary set of testing rules that could be used to (unambiguously) build software with. An impact assessment should also be included, when applicable.
- Proposed testing rules will be reviewed by the Certification Subgroup.
- Once approved, a draft specification should be created. Please use the RCP Template. If the change proposal is based on an existing RCP, please create a new branch from the existing proposal. Otherwise, create a new branch.
Draft Specification and Testing Rules
- The Certification Subgroup will review the draft specification. Once approved, a draft PR will be made.
- The proposal will stay in draft status until it has at least two implementations from two separate vendors.
- Implementations must be verified against the proposed testing rules by RESO staff, even if on a development server. Contact email@example.com for verification.
- Once implementations have been verified, the proposal will be approved by the Certification Subgroup and sent to Transport for final approval. Keep in mind that additional changes may be requested by the community before proceeding.
Approval and Adoption Phase
- At this point, the RCP is ready for approval by the Transport Workgroup. If the change proposal is based on an existing specification, Transport will decide which version of the specification the changes will apply to.
- There may also be a motion to create certification tools and potentially new reports or metrics. These items will be added to RESO’s backlog, once approved.
- A motion and second will be made to adopt the specification.
- If testing tools are to be created, that work must be complete before ratification.
- The proposal will be sent to the RESO Board of Directors to be ratified.
Please contact firstname.lastname@example.org if you have any questions.