errose28 commented on code in PR #188: URL: https://github.com/apache/ozone-site/pull/188#discussion_r2732780029
########## docs/08-developer-guide/04-project/03-ozone-enhancement-proposals.md: ########## @@ -0,0 +1,102 @@ +--- +sidebar_label: Ozone Enhancement Proposals +--- + +# Ozone Enhancement Proposals + +For large features or changes, we use a process called "Ozone Enhancement Proposals" (OEPs) +to ensure that major modifications to Ozone are well-designed and have community consensus. + +If you plan to propose a significant change, please follow the process below +and create a design document *before* you start coding. + +**Note:** Design documents must be in Markdown format. We no longer accept PDFs or Google Docs. + +## OEP Process + +1. **Create a Jira:** Open a dedicated Jira ticket for the proposal. The ticket ID should start with the component prefix (e.g., `HDDS-`) and the title should be prefixed with `[OEP]`. +2. **Write the Design Doc:** Create the design document in Markdown format using the template below. Place the new file in the `hadoop-hdds/docs/content/design` directory. +3. **Submit a Pull Request:** Create a pull request to add the design document to the documentation. +4. **Discuss:** The community will discuss the proposal on the pull request. The discussion follows a lazy consensus model unless a formal vote is called. +5. **Update:** The design document can be updated based on feedback and changes during implementation. + +## Document Template + +The following is the proposed template for an OEP. While it is not mandatory to follow this exact structure, +your proposal should include the following sections. Some proposals may require a different structure +to best convey their design. + +```markdown +--- +title: A sample OEP template +summary: draft a proposal using this template +date: 2025-12-31 +jira: HDDS-14298 +status: implemented +author: Wei-Chiu Chuang +--- Review Comment: `authors` should probably also support a list, like: ```yaml authors: - first author - second author ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
