errose28 commented on code in PR #132: URL: https://github.com/apache/ozone-site/pull/132#discussion_r1996285482
########## src/pages/community/how-to-contribute.md: ########## @@ -1,12 +1,122 @@ -# How to Contribute +# How to Contribute to Apache Ozone -**TODO [HDDS-9869](https://issues.apache.org/jira/browse/HDDS-9869) Fill in this page.** +Thank you for your interest in contributing to Apache Ozone! This guide will help you understand the various ways you can contribute to the project and how to get started. -This may end up similar to CONTRIBUTING.md in the Ozone repo, but should document all the ways to contribute outside of code as well. +## Quick Links -- Testing and filing issues - - This may link to the [Report an Issue](report-an-issue) page. -- Contributing code - - Both Ozone backend and Recon UI/UX front end. -- Contributing to the website -- Graphic design work for logos or diagrams. +- [GitHub Repository](https://github.com/apache/ozone) +- [CONTRIBUTING.md](https://github.com/apache/ozone/blob/master/CONTRIBUTING.md) - Detailed contribution guidelines +- [Newbie Jira Issues](https://issues.apache.org/jira/issues/?filter=12353868) - Good first issues for new contributors Review Comment: We can embed the jql in the URL so this is not dependent on someone not deleting the filter later. ```suggestion - [Newbie Jira Issues](https://issues.apache.org/jira/issues/?jql=labels%20%3D%20newbie%20AND%20project%20%3D%20%22Apache%20Ozone%22%20AND%20status%20%3D%20open%20ORDER%20BY%20created) - Good first issues for new contributors ``` ########## src/pages/community/how-to-contribute.md: ########## @@ -1,12 +1,122 @@ -# How to Contribute +# How to Contribute to Apache Ozone -**TODO [HDDS-9869](https://issues.apache.org/jira/browse/HDDS-9869) Fill in this page.** +Thank you for your interest in contributing to Apache Ozone! This guide will help you understand the various ways you can contribute to the project and how to get started. -This may end up similar to CONTRIBUTING.md in the Ozone repo, but should document all the ways to contribute outside of code as well. +## Quick Links -- Testing and filing issues - - This may link to the [Report an Issue](report-an-issue) page. -- Contributing code - - Both Ozone backend and Recon UI/UX front end. -- Contributing to the website -- Graphic design work for logos or diagrams. +- [GitHub Repository](https://github.com/apache/ozone) +- [CONTRIBUTING.md](https://github.com/apache/ozone/blob/master/CONTRIBUTING.md) - Detailed contribution guidelines +- [Newbie Jira Issues](https://issues.apache.org/jira/issues/?filter=12353868) - Good first issues for new contributors +- [GitHub Discussions](https://github.com/apache/ozone/discussions) - Engage with the community +- [Ozone Website](https://ozone.apache.org/) - Project documentation +- [Slack Channel](http://s.apache.org/slack-invite) - Join #ozone on ASF Slack + +## Ways to Contribute + +Apache Ozone welcomes contributions in many forms, not just code. Here are various ways you can contribute: + +### 1. Code Contributions + +#### Finding Issues to Work On + +- **Newbie Issues**: Start with [beginner-friendly issues](https://issues.apache.org/jira/issues/?filter=12353868) that are good entry points +- **All Open Issues**: Browse [unassigned Jira issues](https://s.apache.org/OzoneUnassignedJiras) to find something that matches your interests and skills Review Comment: I guess the ASF URL shortener is reliable but I would still rather use JQL to be really sure links don't break later. I don't think the URL shortener makes much difference inside a markdown link. ########## src/pages/community/how-to-contribute.md: ########## @@ -1,12 +1,122 @@ -# How to Contribute +# How to Contribute to Apache Ozone -**TODO [HDDS-9869](https://issues.apache.org/jira/browse/HDDS-9869) Fill in this page.** +Thank you for your interest in contributing to Apache Ozone! This guide will help you understand the various ways you can contribute to the project and how to get started. -This may end up similar to CONTRIBUTING.md in the Ozone repo, but should document all the ways to contribute outside of code as well. +## Quick Links -- Testing and filing issues - - This may link to the [Report an Issue](report-an-issue) page. -- Contributing code - - Both Ozone backend and Recon UI/UX front end. -- Contributing to the website -- Graphic design work for logos or diagrams. +- [GitHub Repository](https://github.com/apache/ozone) +- [CONTRIBUTING.md](https://github.com/apache/ozone/blob/master/CONTRIBUTING.md) - Detailed contribution guidelines +- [Newbie Jira Issues](https://issues.apache.org/jira/issues/?filter=12353868) - Good first issues for new contributors +- [GitHub Discussions](https://github.com/apache/ozone/discussions) - Engage with the community +- [Ozone Website](https://ozone.apache.org/) - Project documentation +- [Slack Channel](http://s.apache.org/slack-invite) - Join #ozone on ASF Slack + +## Ways to Contribute + +Apache Ozone welcomes contributions in many forms, not just code. Here are various ways you can contribute: + +### 1. Code Contributions + +#### Finding Issues to Work On + +- **Newbie Issues**: Start with [beginner-friendly issues](https://issues.apache.org/jira/issues/?filter=12353868) that are good entry points +- **All Open Issues**: Browse [unassigned Jira issues](https://s.apache.org/OzoneUnassignedJiras) to find something that matches your interests and skills + +#### Making Code Changes + +1. **Set Up Development Environment** + - Fork and clone the repository + - Enable the `build-branch` GitHub Actions workflow in your fork + +2. **Create a Branch** + - Ensure a Jira issue exists for your task (e.g., HDDS-1234) + - Create a branch for your work: `git checkout -b HDDS-1234` + +3. **Develop Your Changes** + - Follow code style guidelines (2 spaces indentation, 120-char line length) + - Write tests for your changes + - Run relevant checks from `hadoop-ozone/dev-support/checks/` directory + +4. **Submit Your Contribution** + - Push changes to your fork + - Wait for the `build-branch` workflow to complete + - Create a pull request with a clear description + - Update the Jira issue status to "Patch Available" + +### 2. Documentation + +- **Website Improvements**: Contribute to the [Ozone website](https://ozone.apache.org/) - see [instructions](https://cwiki.apache.org/confluence/display/OZONE/Modifying+the+Ozone+Website) +- **Developer Docs**: Enhance the [markdown documentation](https://github.com/apache/ozone/tree/master/hadoop-hdds/docs/content) in the source tree +- **Wiki Pages**: Update the [project wiki](https://cwiki.apache.org/confluence/display/OZONE) (request access through [email protected]) + +### 3. Testing + +- **Unit Tests**: Write JUnit tests for Java code +- **Acceptance Tests**: Create Docker + Robot Framework tests +- **Blockade Tests**: Develop Python + Blockade tests +- **Performance Testing**: Run benchmarks with `ozone freon` and report findings + +### 4. Visual Design & Art + +Ozone welcomes contributions in design and visual arts: + +- **Logos and Icons**: Create variations of the Ozone logo for different contexts +- **Diagrams**: Design architectural and conceptual diagrams for documentation +- **Website Design**: Improve the look and feel of the Ozone website +- **Slide Decks**: Design templates for presentations about Ozone + +Share your artwork through the [GitHub Discussions](https://github.com/apache/ozone/discussions) or on the dev mailing list [email protected]. + +### 5. Bug Reports and Feature Requests + +- Report bugs or suggest features through [Jira](https://issues.apache.org/jira/projects/HDDS/) +- Search existing issues before creating a new one +- Provide detailed steps to reproduce bugs + +### 6. Community Support + +- Answer questions on [GitHub Discussions](https://github.com/apache/ozone/discussions) +- Help review pull requests Review Comment: ```suggestion - Help review [pull requests](https://github.com/apache/ozone/pulls) ``` ########## src/pages/community/how-to-contribute.md: ########## @@ -1,12 +1,122 @@ -# How to Contribute +# How to Contribute to Apache Ozone -**TODO [HDDS-9869](https://issues.apache.org/jira/browse/HDDS-9869) Fill in this page.** +Thank you for your interest in contributing to Apache Ozone! This guide will help you understand the various ways you can contribute to the project and how to get started. -This may end up similar to CONTRIBUTING.md in the Ozone repo, but should document all the ways to contribute outside of code as well. +## Quick Links -- Testing and filing issues - - This may link to the [Report an Issue](report-an-issue) page. -- Contributing code - - Both Ozone backend and Recon UI/UX front end. -- Contributing to the website -- Graphic design work for logos or diagrams. +- [GitHub Repository](https://github.com/apache/ozone) +- [CONTRIBUTING.md](https://github.com/apache/ozone/blob/master/CONTRIBUTING.md) - Detailed contribution guidelines +- [Newbie Jira Issues](https://issues.apache.org/jira/issues/?filter=12353868) - Good first issues for new contributors +- [GitHub Discussions](https://github.com/apache/ozone/discussions) - Engage with the community +- [Ozone Website](https://ozone.apache.org/) - Project documentation +- [Slack Channel](http://s.apache.org/slack-invite) - Join #ozone on ASF Slack + +## Ways to Contribute + +Apache Ozone welcomes contributions in many forms, not just code. Here are various ways you can contribute: + +### 1. Code Contributions + +#### Finding Issues to Work On + +- **Newbie Issues**: Start with [beginner-friendly issues](https://issues.apache.org/jira/issues/?filter=12353868) that are good entry points +- **All Open Issues**: Browse [unassigned Jira issues](https://s.apache.org/OzoneUnassignedJiras) to find something that matches your interests and skills + +#### Making Code Changes + +1. **Set Up Development Environment** + - Fork and clone the repository + - Enable the `build-branch` GitHub Actions workflow in your fork + +2. **Create a Branch** + - Ensure a Jira issue exists for your task (e.g., HDDS-1234) + - Create a branch for your work: `git checkout -b HDDS-1234` + +3. **Develop Your Changes** + - Follow code style guidelines (2 spaces indentation, 120-char line length) + - Write tests for your changes + - Run relevant checks from `hadoop-ozone/dev-support/checks/` directory + +4. **Submit Your Contribution** + - Push changes to your fork + - Wait for the `build-branch` workflow to complete + - Create a pull request with a clear description + - Update the Jira issue status to "Patch Available" + +### 2. Documentation + +- **Website Improvements**: Contribute to the [Ozone website](https://ozone.apache.org/) - see [instructions](https://cwiki.apache.org/confluence/display/OZONE/Modifying+the+Ozone+Website) Review Comment: Since this page is going into the new website, let's link to CONTRIBUTING.md in this repo instead. Ideally all confluence content will be obsolete and removed when this site goes live. ########## src/pages/community/how-to-contribute.md: ########## @@ -1,12 +1,122 @@ -# How to Contribute +# How to Contribute to Apache Ozone -**TODO [HDDS-9869](https://issues.apache.org/jira/browse/HDDS-9869) Fill in this page.** +Thank you for your interest in contributing to Apache Ozone! This guide will help you understand the various ways you can contribute to the project and how to get started. -This may end up similar to CONTRIBUTING.md in the Ozone repo, but should document all the ways to contribute outside of code as well. +## Quick Links -- Testing and filing issues - - This may link to the [Report an Issue](report-an-issue) page. -- Contributing code - - Both Ozone backend and Recon UI/UX front end. -- Contributing to the website -- Graphic design work for logos or diagrams. +- [GitHub Repository](https://github.com/apache/ozone) +- [CONTRIBUTING.md](https://github.com/apache/ozone/blob/master/CONTRIBUTING.md) - Detailed contribution guidelines +- [Newbie Jira Issues](https://issues.apache.org/jira/issues/?filter=12353868) - Good first issues for new contributors +- [GitHub Discussions](https://github.com/apache/ozone/discussions) - Engage with the community +- [Ozone Website](https://ozone.apache.org/) - Project documentation +- [Slack Channel](http://s.apache.org/slack-invite) - Join #ozone on ASF Slack + +## Ways to Contribute Review Comment: [Yunikorn](https://yunikorn.apache.org/community/how_to_contribute#jira-signup) has a good section on Jira signup and etiquette and it would be good to include something similar on our website. It might be better to have a dedicated page in the developer guide and link it here to keep this one concise. ########## src/pages/community/how-to-contribute.md: ########## @@ -1,12 +1,122 @@ -# How to Contribute +# How to Contribute to Apache Ozone -**TODO [HDDS-9869](https://issues.apache.org/jira/browse/HDDS-9869) Fill in this page.** +Thank you for your interest in contributing to Apache Ozone! This guide will help you understand the various ways you can contribute to the project and how to get started. -This may end up similar to CONTRIBUTING.md in the Ozone repo, but should document all the ways to contribute outside of code as well. +## Quick Links -- Testing and filing issues - - This may link to the [Report an Issue](report-an-issue) page. -- Contributing code - - Both Ozone backend and Recon UI/UX front end. -- Contributing to the website -- Graphic design work for logos or diagrams. +- [GitHub Repository](https://github.com/apache/ozone) +- [CONTRIBUTING.md](https://github.com/apache/ozone/blob/master/CONTRIBUTING.md) - Detailed contribution guidelines +- [Newbie Jira Issues](https://issues.apache.org/jira/issues/?filter=12353868) - Good first issues for new contributors +- [GitHub Discussions](https://github.com/apache/ozone/discussions) - Engage with the community +- [Ozone Website](https://ozone.apache.org/) - Project documentation +- [Slack Channel](http://s.apache.org/slack-invite) - Join #ozone on ASF Slack + +## Ways to Contribute + +Apache Ozone welcomes contributions in many forms, not just code. Here are various ways you can contribute: + +### 1. Code Contributions + +#### Finding Issues to Work On + +- **Newbie Issues**: Start with [beginner-friendly issues](https://issues.apache.org/jira/issues/?filter=12353868) that are good entry points +- **All Open Issues**: Browse [unassigned Jira issues](https://s.apache.org/OzoneUnassignedJiras) to find something that matches your interests and skills + +#### Making Code Changes + +1. **Set Up Development Environment** + - Fork and clone the repository + - Enable the `build-branch` GitHub Actions workflow in your fork + +2. **Create a Branch** + - Ensure a Jira issue exists for your task (e.g., HDDS-1234) + - Create a branch for your work: `git checkout -b HDDS-1234` + +3. **Develop Your Changes** + - Follow code style guidelines (2 spaces indentation, 120-char line length) + - Write tests for your changes + - Run relevant checks from `hadoop-ozone/dev-support/checks/` directory + +4. **Submit Your Contribution** + - Push changes to your fork + - Wait for the `build-branch` workflow to complete + - Create a pull request with a clear description + - Update the Jira issue status to "Patch Available" + +### 2. Documentation + +- **Website Improvements**: Contribute to the [Ozone website](https://ozone.apache.org/) - see [instructions](https://cwiki.apache.org/confluence/display/OZONE/Modifying+the+Ozone+Website) Review Comment: Same for other links in this section. ########## src/pages/community/how-to-contribute.md: ########## @@ -1,12 +1,122 @@ -# How to Contribute +# How to Contribute to Apache Ozone -**TODO [HDDS-9869](https://issues.apache.org/jira/browse/HDDS-9869) Fill in this page.** +Thank you for your interest in contributing to Apache Ozone! This guide will help you understand the various ways you can contribute to the project and how to get started. -This may end up similar to CONTRIBUTING.md in the Ozone repo, but should document all the ways to contribute outside of code as well. +## Quick Links -- Testing and filing issues - - This may link to the [Report an Issue](report-an-issue) page. -- Contributing code - - Both Ozone backend and Recon UI/UX front end. -- Contributing to the website -- Graphic design work for logos or diagrams. +- [GitHub Repository](https://github.com/apache/ozone) +- [CONTRIBUTING.md](https://github.com/apache/ozone/blob/master/CONTRIBUTING.md) - Detailed contribution guidelines +- [Newbie Jira Issues](https://issues.apache.org/jira/issues/?filter=12353868) - Good first issues for new contributors +- [GitHub Discussions](https://github.com/apache/ozone/discussions) - Engage with the community +- [Ozone Website](https://ozone.apache.org/) - Project documentation +- [Slack Channel](http://s.apache.org/slack-invite) - Join #ozone on ASF Slack + +## Ways to Contribute + +Apache Ozone welcomes contributions in many forms, not just code. Here are various ways you can contribute: + +### 1. Code Contributions Review Comment: I don't think we need lists in the heading syntax here. These aren't ordered steps and markdownlint won't check the headings as a list to make sure numbering remains consistent. ########## src/pages/community/how-to-contribute.md: ########## @@ -1,12 +1,122 @@ -# How to Contribute +# How to Contribute to Apache Ozone -**TODO [HDDS-9869](https://issues.apache.org/jira/browse/HDDS-9869) Fill in this page.** +Thank you for your interest in contributing to Apache Ozone! This guide will help you understand the various ways you can contribute to the project and how to get started. -This may end up similar to CONTRIBUTING.md in the Ozone repo, but should document all the ways to contribute outside of code as well. +## Quick Links -- Testing and filing issues - - This may link to the [Report an Issue](report-an-issue) page. -- Contributing code - - Both Ozone backend and Recon UI/UX front end. -- Contributing to the website -- Graphic design work for logos or diagrams. +- [GitHub Repository](https://github.com/apache/ozone) +- [CONTRIBUTING.md](https://github.com/apache/ozone/blob/master/CONTRIBUTING.md) - Detailed contribution guidelines +- [Newbie Jira Issues](https://issues.apache.org/jira/issues/?filter=12353868) - Good first issues for new contributors +- [GitHub Discussions](https://github.com/apache/ozone/discussions) - Engage with the community +- [Ozone Website](https://ozone.apache.org/) - Project documentation +- [Slack Channel](http://s.apache.org/slack-invite) - Join #ozone on ASF Slack + +## Ways to Contribute + +Apache Ozone welcomes contributions in many forms, not just code. Here are various ways you can contribute: + +### 1. Code Contributions + +#### Finding Issues to Work On Review Comment: I would make "finding issues" step one and put this as one list under the "Code Contributions" heading. ########## src/pages/community/how-to-contribute.md: ########## @@ -1,12 +1,122 @@ -# How to Contribute +# How to Contribute to Apache Ozone -**TODO [HDDS-9869](https://issues.apache.org/jira/browse/HDDS-9869) Fill in this page.** +Thank you for your interest in contributing to Apache Ozone! This guide will help you understand the various ways you can contribute to the project and how to get started. -This may end up similar to CONTRIBUTING.md in the Ozone repo, but should document all the ways to contribute outside of code as well. +## Quick Links -- Testing and filing issues - - This may link to the [Report an Issue](report-an-issue) page. -- Contributing code - - Both Ozone backend and Recon UI/UX front end. -- Contributing to the website -- Graphic design work for logos or diagrams. +- [GitHub Repository](https://github.com/apache/ozone) +- [CONTRIBUTING.md](https://github.com/apache/ozone/blob/master/CONTRIBUTING.md) - Detailed contribution guidelines +- [Newbie Jira Issues](https://issues.apache.org/jira/issues/?filter=12353868) - Good first issues for new contributors +- [GitHub Discussions](https://github.com/apache/ozone/discussions) - Engage with the community +- [Ozone Website](https://ozone.apache.org/) - Project documentation +- [Slack Channel](http://s.apache.org/slack-invite) - Join #ozone on ASF Slack + +## Ways to Contribute + +Apache Ozone welcomes contributions in many forms, not just code. Here are various ways you can contribute: + +### 1. Code Contributions + +#### Finding Issues to Work On + +- **Newbie Issues**: Start with [beginner-friendly issues](https://issues.apache.org/jira/issues/?filter=12353868) that are good entry points +- **All Open Issues**: Browse [unassigned Jira issues](https://s.apache.org/OzoneUnassignedJiras) to find something that matches your interests and skills + +#### Making Code Changes + +1. **Set Up Development Environment** + - Fork and clone the repository + - Enable the `build-branch` GitHub Actions workflow in your fork + +2. **Create a Branch** + - Ensure a Jira issue exists for your task (e.g., HDDS-1234) + - Create a branch for your work: `git checkout -b HDDS-1234` + +3. **Develop Your Changes** + - Follow code style guidelines (2 spaces indentation, 120-char line length) + - Write tests for your changes + - Run relevant checks from `hadoop-ozone/dev-support/checks/` directory + +4. **Submit Your Contribution** + - Push changes to your fork + - Wait for the `build-branch` workflow to complete + - Create a pull request with a clear description + - Update the Jira issue status to "Patch Available" + +### 2. Documentation + +- **Website Improvements**: Contribute to the [Ozone website](https://ozone.apache.org/) - see [instructions](https://cwiki.apache.org/confluence/display/OZONE/Modifying+the+Ozone+Website) +- **Developer Docs**: Enhance the [markdown documentation](https://github.com/apache/ozone/tree/master/hadoop-hdds/docs/content) in the source tree +- **Wiki Pages**: Update the [project wiki](https://cwiki.apache.org/confluence/display/OZONE) (request access through [email protected]) + +### 3. Testing + +- **Unit Tests**: Write JUnit tests for Java code +- **Acceptance Tests**: Create Docker + Robot Framework tests +- **Blockade Tests**: Develop Python + Blockade tests Review Comment: I don't think we actually use blockade anymore. ########## src/pages/community/how-to-contribute.md: ########## @@ -1,12 +1,122 @@ -# How to Contribute +# How to Contribute to Apache Ozone -**TODO [HDDS-9869](https://issues.apache.org/jira/browse/HDDS-9869) Fill in this page.** +Thank you for your interest in contributing to Apache Ozone! This guide will help you understand the various ways you can contribute to the project and how to get started. -This may end up similar to CONTRIBUTING.md in the Ozone repo, but should document all the ways to contribute outside of code as well. +## Quick Links -- Testing and filing issues - - This may link to the [Report an Issue](report-an-issue) page. -- Contributing code - - Both Ozone backend and Recon UI/UX front end. -- Contributing to the website -- Graphic design work for logos or diagrams. +- [GitHub Repository](https://github.com/apache/ozone) +- [CONTRIBUTING.md](https://github.com/apache/ozone/blob/master/CONTRIBUTING.md) - Detailed contribution guidelines +- [Newbie Jira Issues](https://issues.apache.org/jira/issues/?filter=12353868) - Good first issues for new contributors +- [GitHub Discussions](https://github.com/apache/ozone/discussions) - Engage with the community +- [Ozone Website](https://ozone.apache.org/) - Project documentation +- [Slack Channel](http://s.apache.org/slack-invite) - Join #ozone on ASF Slack + +## Ways to Contribute + +Apache Ozone welcomes contributions in many forms, not just code. Here are various ways you can contribute: + +### 1. Code Contributions + +#### Finding Issues to Work On + +- **Newbie Issues**: Start with [beginner-friendly issues](https://issues.apache.org/jira/issues/?filter=12353868) that are good entry points +- **All Open Issues**: Browse [unassigned Jira issues](https://s.apache.org/OzoneUnassignedJiras) to find something that matches your interests and skills + Review Comment: We should link to the developer guide at the end here for more information. ########## src/pages/community/how-to-contribute.md: ########## @@ -1,12 +1,122 @@ -# How to Contribute +# How to Contribute to Apache Ozone -**TODO [HDDS-9869](https://issues.apache.org/jira/browse/HDDS-9869) Fill in this page.** +Thank you for your interest in contributing to Apache Ozone! This guide will help you understand the various ways you can contribute to the project and how to get started. -This may end up similar to CONTRIBUTING.md in the Ozone repo, but should document all the ways to contribute outside of code as well. +## Quick Links -- Testing and filing issues - - This may link to the [Report an Issue](report-an-issue) page. -- Contributing code - - Both Ozone backend and Recon UI/UX front end. -- Contributing to the website -- Graphic design work for logos or diagrams. +- [GitHub Repository](https://github.com/apache/ozone) +- [CONTRIBUTING.md](https://github.com/apache/ozone/blob/master/CONTRIBUTING.md) - Detailed contribution guidelines +- [Newbie Jira Issues](https://issues.apache.org/jira/issues/?filter=12353868) - Good first issues for new contributors +- [GitHub Discussions](https://github.com/apache/ozone/discussions) - Engage with the community +- [Ozone Website](https://ozone.apache.org/) - Project documentation +- [Slack Channel](http://s.apache.org/slack-invite) - Join #ozone on ASF Slack + +## Ways to Contribute + +Apache Ozone welcomes contributions in many forms, not just code. Here are various ways you can contribute: + +### 1. Code Contributions + +#### Finding Issues to Work On + +- **Newbie Issues**: Start with [beginner-friendly issues](https://issues.apache.org/jira/issues/?filter=12353868) that are good entry points +- **All Open Issues**: Browse [unassigned Jira issues](https://s.apache.org/OzoneUnassignedJiras) to find something that matches your interests and skills + +#### Making Code Changes + +1. **Set Up Development Environment** + - Fork and clone the repository + - Enable the `build-branch` GitHub Actions workflow in your fork + +2. **Create a Branch** + - Ensure a Jira issue exists for your task (e.g., HDDS-1234) + - Create a branch for your work: `git checkout -b HDDS-1234` + +3. **Develop Your Changes** + - Follow code style guidelines (2 spaces indentation, 120-char line length) + - Write tests for your changes + - Run relevant checks from `hadoop-ozone/dev-support/checks/` directory + +4. **Submit Your Contribution** + - Push changes to your fork + - Wait for the `build-branch` workflow to complete + - Create a pull request with a clear description + - Update the Jira issue status to "Patch Available" + +### 2. Documentation + +- **Website Improvements**: Contribute to the [Ozone website](https://ozone.apache.org/) - see [instructions](https://cwiki.apache.org/confluence/display/OZONE/Modifying+the+Ozone+Website) +- **Developer Docs**: Enhance the [markdown documentation](https://github.com/apache/ozone/tree/master/hadoop-hdds/docs/content) in the source tree +- **Wiki Pages**: Update the [project wiki](https://cwiki.apache.org/confluence/display/OZONE) (request access through [email protected]) + +### 3. Testing + +- **Unit Tests**: Write JUnit tests for Java code +- **Acceptance Tests**: Create Docker + Robot Framework tests +- **Blockade Tests**: Develop Python + Blockade tests +- **Performance Testing**: Run benchmarks with `ozone freon` and report findings + Review Comment: Here also we can link to the testing section in the developer guide for more information. ########## src/pages/community/how-to-contribute.md: ########## @@ -1,12 +1,122 @@ -# How to Contribute +# How to Contribute to Apache Ozone -**TODO [HDDS-9869](https://issues.apache.org/jira/browse/HDDS-9869) Fill in this page.** +Thank you for your interest in contributing to Apache Ozone! This guide will help you understand the various ways you can contribute to the project and how to get started. -This may end up similar to CONTRIBUTING.md in the Ozone repo, but should document all the ways to contribute outside of code as well. +## Quick Links -- Testing and filing issues - - This may link to the [Report an Issue](report-an-issue) page. -- Contributing code - - Both Ozone backend and Recon UI/UX front end. -- Contributing to the website -- Graphic design work for logos or diagrams. +- [GitHub Repository](https://github.com/apache/ozone) +- [CONTRIBUTING.md](https://github.com/apache/ozone/blob/master/CONTRIBUTING.md) - Detailed contribution guidelines +- [Newbie Jira Issues](https://issues.apache.org/jira/issues/?filter=12353868) - Good first issues for new contributors +- [GitHub Discussions](https://github.com/apache/ozone/discussions) - Engage with the community +- [Ozone Website](https://ozone.apache.org/) - Project documentation +- [Slack Channel](http://s.apache.org/slack-invite) - Join #ozone on ASF Slack + +## Ways to Contribute + +Apache Ozone welcomes contributions in many forms, not just code. Here are various ways you can contribute: + +### 1. Code Contributions + +#### Finding Issues to Work On + +- **Newbie Issues**: Start with [beginner-friendly issues](https://issues.apache.org/jira/issues/?filter=12353868) that are good entry points +- **All Open Issues**: Browse [unassigned Jira issues](https://s.apache.org/OzoneUnassignedJiras) to find something that matches your interests and skills + +#### Making Code Changes + +1. **Set Up Development Environment** + - Fork and clone the repository + - Enable the `build-branch` GitHub Actions workflow in your fork + +2. **Create a Branch** + - Ensure a Jira issue exists for your task (e.g., HDDS-1234) + - Create a branch for your work: `git checkout -b HDDS-1234` + +3. **Develop Your Changes** + - Follow code style guidelines (2 spaces indentation, 120-char line length) + - Write tests for your changes + - Run relevant checks from `hadoop-ozone/dev-support/checks/` directory + +4. **Submit Your Contribution** + - Push changes to your fork + - Wait for the `build-branch` workflow to complete + - Create a pull request with a clear description + - Update the Jira issue status to "Patch Available" + +### 2. Documentation + +- **Website Improvements**: Contribute to the [Ozone website](https://ozone.apache.org/) - see [instructions](https://cwiki.apache.org/confluence/display/OZONE/Modifying+the+Ozone+Website) +- **Developer Docs**: Enhance the [markdown documentation](https://github.com/apache/ozone/tree/master/hadoop-hdds/docs/content) in the source tree +- **Wiki Pages**: Update the [project wiki](https://cwiki.apache.org/confluence/display/OZONE) (request access through [email protected]) + +### 3. Testing + +- **Unit Tests**: Write JUnit tests for Java code +- **Acceptance Tests**: Create Docker + Robot Framework tests +- **Blockade Tests**: Develop Python + Blockade tests +- **Performance Testing**: Run benchmarks with `ozone freon` and report findings + +### 4. Visual Design & Art + +Ozone welcomes contributions in design and visual arts: + +- **Logos and Icons**: Create variations of the Ozone logo for different contexts +- **Diagrams**: Design architectural and conceptual diagrams for documentation +- **Website Design**: Improve the look and feel of the Ozone website +- **Slide Decks**: Design templates for presentations about Ozone + +Share your artwork through the [GitHub Discussions](https://github.com/apache/ozone/discussions) or on the dev mailing list [email protected]. + +### 5. Bug Reports and Feature Requests + +- Report bugs or suggest features through [Jira](https://issues.apache.org/jira/projects/HDDS/) +- Search existing issues before creating a new one +- Provide detailed steps to reproduce bugs + +### 6. Community Support + +- Answer questions on [GitHub Discussions](https://github.com/apache/ozone/discussions) +- Help review pull requests +- Join community calls and discussions Review Comment: We can link to the [communication channels](https://ozone-site-v2.staged.apache.org/community/communication-channels) page here for more info. ########## src/pages/community/how-to-contribute.md: ########## @@ -1,12 +1,122 @@ -# How to Contribute +# How to Contribute to Apache Ozone -**TODO [HDDS-9869](https://issues.apache.org/jira/browse/HDDS-9869) Fill in this page.** +Thank you for your interest in contributing to Apache Ozone! This guide will help you understand the various ways you can contribute to the project and how to get started. -This may end up similar to CONTRIBUTING.md in the Ozone repo, but should document all the ways to contribute outside of code as well. +## Quick Links -- Testing and filing issues - - This may link to the [Report an Issue](report-an-issue) page. -- Contributing code - - Both Ozone backend and Recon UI/UX front end. -- Contributing to the website -- Graphic design work for logos or diagrams. +- [GitHub Repository](https://github.com/apache/ozone) +- [CONTRIBUTING.md](https://github.com/apache/ozone/blob/master/CONTRIBUTING.md) - Detailed contribution guidelines +- [Newbie Jira Issues](https://issues.apache.org/jira/issues/?filter=12353868) - Good first issues for new contributors +- [GitHub Discussions](https://github.com/apache/ozone/discussions) - Engage with the community +- [Ozone Website](https://ozone.apache.org/) - Project documentation +- [Slack Channel](http://s.apache.org/slack-invite) - Join #ozone on ASF Slack + +## Ways to Contribute + +Apache Ozone welcomes contributions in many forms, not just code. Here are various ways you can contribute: + +### 1. Code Contributions + +#### Finding Issues to Work On + +- **Newbie Issues**: Start with [beginner-friendly issues](https://issues.apache.org/jira/issues/?filter=12353868) that are good entry points +- **All Open Issues**: Browse [unassigned Jira issues](https://s.apache.org/OzoneUnassignedJiras) to find something that matches your interests and skills + +#### Making Code Changes + +1. **Set Up Development Environment** + - Fork and clone the repository + - Enable the `build-branch` GitHub Actions workflow in your fork + +2. **Create a Branch** + - Ensure a Jira issue exists for your task (e.g., HDDS-1234) + - Create a branch for your work: `git checkout -b HDDS-1234` + +3. **Develop Your Changes** + - Follow code style guidelines (2 spaces indentation, 120-char line length) + - Write tests for your changes + - Run relevant checks from `hadoop-ozone/dev-support/checks/` directory + +4. **Submit Your Contribution** + - Push changes to your fork + - Wait for the `build-branch` workflow to complete + - Create a pull request with a clear description + - Update the Jira issue status to "Patch Available" + +### 2. Documentation + +- **Website Improvements**: Contribute to the [Ozone website](https://ozone.apache.org/) - see [instructions](https://cwiki.apache.org/confluence/display/OZONE/Modifying+the+Ozone+Website) +- **Developer Docs**: Enhance the [markdown documentation](https://github.com/apache/ozone/tree/master/hadoop-hdds/docs/content) in the source tree +- **Wiki Pages**: Update the [project wiki](https://cwiki.apache.org/confluence/display/OZONE) (request access through [email protected]) + +### 3. Testing + +- **Unit Tests**: Write JUnit tests for Java code +- **Acceptance Tests**: Create Docker + Robot Framework tests +- **Blockade Tests**: Develop Python + Blockade tests +- **Performance Testing**: Run benchmarks with `ozone freon` and report findings + +### 4. Visual Design & Art + +Ozone welcomes contributions in design and visual arts: + +- **Logos and Icons**: Create variations of the Ozone logo for different contexts +- **Diagrams**: Design architectural and conceptual diagrams for documentation +- **Website Design**: Improve the look and feel of the Ozone website +- **Slide Decks**: Design templates for presentations about Ozone + +Share your artwork through the [GitHub Discussions](https://github.com/apache/ozone/discussions) or on the dev mailing list [email protected]. + +### 5. Bug Reports and Feature Requests + +- Report bugs or suggest features through [Jira](https://issues.apache.org/jira/projects/HDDS/) +- Search existing issues before creating a new one +- Provide detailed steps to reproduce bugs + +### 6. Community Support + +- Answer questions on [GitHub Discussions](https://github.com/apache/ozone/discussions) +- Help review pull requests +- Join community calls and discussions + +## Getting Help Review Comment: This section looks like it will duplicate content in the communication channels page. ########## src/pages/community/how-to-contribute.md: ########## @@ -1,12 +1,122 @@ -# How to Contribute +# How to Contribute to Apache Ozone -**TODO [HDDS-9869](https://issues.apache.org/jira/browse/HDDS-9869) Fill in this page.** +Thank you for your interest in contributing to Apache Ozone! This guide will help you understand the various ways you can contribute to the project and how to get started. -This may end up similar to CONTRIBUTING.md in the Ozone repo, but should document all the ways to contribute outside of code as well. +## Quick Links -- Testing and filing issues - - This may link to the [Report an Issue](report-an-issue) page. -- Contributing code - - Both Ozone backend and Recon UI/UX front end. -- Contributing to the website -- Graphic design work for logos or diagrams. +- [GitHub Repository](https://github.com/apache/ozone) +- [CONTRIBUTING.md](https://github.com/apache/ozone/blob/master/CONTRIBUTING.md) - Detailed contribution guidelines +- [Newbie Jira Issues](https://issues.apache.org/jira/issues/?filter=12353868) - Good first issues for new contributors +- [GitHub Discussions](https://github.com/apache/ozone/discussions) - Engage with the community +- [Ozone Website](https://ozone.apache.org/) - Project documentation +- [Slack Channel](http://s.apache.org/slack-invite) - Join #ozone on ASF Slack + +## Ways to Contribute + +Apache Ozone welcomes contributions in many forms, not just code. Here are various ways you can contribute: + +### 1. Code Contributions + +#### Finding Issues to Work On + +- **Newbie Issues**: Start with [beginner-friendly issues](https://issues.apache.org/jira/issues/?filter=12353868) that are good entry points +- **All Open Issues**: Browse [unassigned Jira issues](https://s.apache.org/OzoneUnassignedJiras) to find something that matches your interests and skills + +#### Making Code Changes + +1. **Set Up Development Environment** + - Fork and clone the repository + - Enable the `build-branch` GitHub Actions workflow in your fork + +2. **Create a Branch** + - Ensure a Jira issue exists for your task (e.g., HDDS-1234) + - Create a branch for your work: `git checkout -b HDDS-1234` Review Comment: We should note that all Ozone changes will be merged back to `master` -- 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]
