Ray Enhancement Proposals is a governance framework that manages the proposal, discussion, and approval process for major features and changes to the Ray distributed computing project.
The tool addresses the need for structured decision-making around significant modifications to Ray. It establishes a formal process where proposals are submitted as pull requests, reviewed by a designated senior committer shepherd, refined through community discussion, voted on by Ray committers via mailing list, and either merged for approval or closed for rejection. The framework distinguishes between changes that belong in the core Ray repository, ecosystem projects under the Ray organization, and external projects, with different review standards applied to each category.
Teams adopting this approach should understand that it requires commitment to a multi-stage review cycle involving shepherd oversight, committer voting, and potential escalation to final decision-makers. The process suits organizations building distributed systems or large open-source projects where architectural decisions need broad consensus and documented rationale. The framework is particularly valuable when you need to prevent ad-hoc feature additions and ensure that changes align with long-term project direction. The README does not compare this approach to alternative governance models.
The project maintains an active pull request queue where both open and merged proposals remain available for ongoing comment and discussion. Proposals are expected to include comprehensive sections covering motivation, use cases, architectural details, stewardship assignments, and required reviewer identification before advancing to the voting stage. The shepherd role creates a clear accountability structure for shepherding proposals through refinement before broader review.
