This is an automated email from the ASF dual-hosted git repository. ritesh pushed a commit to branch gh-pages in repository https://gitbox.apache.org/repos/asf/ozone-site.git
commit a4d08e7806894f78e4ee174d0f7fcebde54b6a9c Author: Ritesh H Shukla <[email protected]> AuthorDate: Wed Mar 26 12:56:52 2025 -0700 HDDS-9618. Add detailed communication channels page. (#3) * HDDS-9618. Add detailed communication channels page. This adds comprehensive instructions for all community communication channels: - Mailing lists with subscription details and best practices - GitHub Discussions with usage guidelines - Slack channel information and best practices - Jira workflow for issue tracking - Community meeting information - Guidance on choosing the right channel --- src/pages/community/communication-channels.md | 127 ++++++++++++++++++++++++-- 1 file changed, 120 insertions(+), 7 deletions(-) diff --git a/src/pages/community/communication-channels.md b/src/pages/community/communication-channels.md index b92de047..3b0d3c98 100644 --- a/src/pages/community/communication-channels.md +++ b/src/pages/community/communication-channels.md @@ -1,11 +1,124 @@ # Communication Channels -**TODO [HDDS-9618](https://issues.apache.org/jira/browse/HDDS-9618) Fill in this page.** +Apache Ozone offers several ways to connect with the community. Whether you have questions, want to contribute, or just follow project discussions, here's how to get involved. -Add links and sign up instructions for all the ways to get in contact with Ozone developers and users. This includes: +## Quick Links -- Apache mailing lists -- Community Meetings -- Github Discussions -- Slack -- Jira +- [Mailing Lists](#mailing-lists): Primary communication for development discussions and decisions +- [GitHub Discussions](#github-discussions): Q&A and community discussions +- [Slack](#slack): Real-time chat with community members +- [Jira](#jira): Issue tracking and project management +- [Community Meetings](#community-meetings): Regular video calls with the community + +## Mailing Lists + +### Dev Mailing List + +For development discussions, design proposals, and community decisions: + +- **Subscribe**: Send an empty email to [[email protected]](mailto:[email protected]) +- **Post messages**: [[email protected]](mailto:[email protected]) (only after subscribing) +- **Unsubscribe**: Send an email to [[email protected]](mailto:[email protected]) +- **Archives**: [Dev List Archives](https://lists.apache.org/[email protected]) + +### User Mailing List + +For user questions and discussions: + +- **Subscribe**: Send an empty email to [[email protected]](mailto:[email protected]) +- **Post messages**: [[email protected]](mailto:[email protected]) (only after subscribing) +- **Unsubscribe**: Send an email to [[email protected]](mailto:[email protected]) +- **Archives**: [User List Archives](https://lists.apache.org/[email protected]) + +### Best Practices for Mailing Lists + +- Include a descriptive subject line +- Search the archives before asking a question +- For technical questions, provide your Ozone version and environment details +- For code snippets, use proper formatting (indent with 4 spaces) +- Respond inline to long emails with multiple points +- Follow the [Apache Code of Conduct](https://www.apache.org/foundation/policies/conduct.html) + +## GitHub Discussions + +[GitHub Discussions](https://github.com/apache/ozone/discussions) is perfect for Q&A, sharing ideas, and community conversations. + +### How to Use GitHub Discussions + +1. Visit the [Ozone Discussions page](https://github.com/apache/ozone/discussions) +2. Sign in with your GitHub account (or create one if needed) +3. Browse existing discussions by category: + - **Q&A**: Technical questions about using Ozone + - **FAQ**: Frequently asked questions + - **Ideas**: Suggestions for new features or improvements + - **Show and Tell**: Share your projects built with Ozone + - **General**: Other discussions about Ozone + +## Slack + +The Ozone community uses Apache Slack for real-time communication and quick questions. + +### How to Join Ozone on Slack + +1. Get an invitation to the ASF Slack workspace by visiting [s.apache.org/slack-invite](http://s.apache.org/slack-invite) +2. After joining, find and join the `#ozone` channel +3. Introduce yourself to the community! + +### Slack Best Practices + +- For complex questions, consider using the mailing list or GitHub Discussions +- Be aware that not all community members are online at the same time due to different time zones +- Important discussions and decisions should be moved to the mailing list +- Slack history might not be permanently archived, so don't rely on it for important information + +## Jira + +[Apache Jira](https://issues.apache.org/jira/projects/HDDS/) is used for tracking issues, bugs, and feature requests for Ozone. + +### How to Use Jira + +1. **Request an account**: Visit [Jira account creation page](https://selfserve.apache.org/jira-account.html). Choose `ozone` as the project and fill in the fields. An Ozone PMC will review and approve. + +2. **Browse issues**: Go to the [Ozone Jira project (HDDS)](https://issues.apache.org/jira/projects/HDDS/) + +3. **Report a new issue**: + - Click "Create" in the top menu + - Use a clear, descriptive title + - Include detailed steps to reproduce bugs + - For feature requests, explain the use case and desired outcome + - Add relevant labels (e.g., "newbie" for beginner-friendly issues) + - Set the issue type (Bug, Improvement, New Feature, etc.) + +4. **Work on an issue**: + - Comment on the issue to express your interest + - Assign it to yourself if you plan to work on it + - Follow the [contribution guidelines](how-to-contribute) to submit a fix + - Update the Jira status as you make progress + +## Community Meetings + +The Ozone community holds regular video calls to discuss project progress, make decisions, and welcome new contributors. + +### Meeting Details + +- **Schedule**: [Check the wiki for the latest schedule](https://cwiki.apache.org/confluence/display/OZONE/Ozone+Community+Calls) +- **Platform**: Usually held on Zoom or Google Meet +- **Calendar**: Subscribe to the [Apache Ozone community calendar](https://calendar.google.com/calendar/embed?src=0h8p6160kkv57mvv0gahqpnr5c%40group.calendar.google.com) +- **Notes**: [Meeting notes are typically shared](https://github.com/apache/ozone/discussions/categories/community-sync-meetings) afterward + +### Participating in Meetings + +- Meetings are open to everyone interested in Ozone +- Feel free to introduce yourself if you're new +- You can suggest topics for discussion on the mailing list before the meeting +- Don't hesitate to ask questions during the call + +## Choosing the Right Channel + +- **Mailing Lists**: For official discussions, design proposals, community decisions +- **GitHub Discussions**: For Q&A, ideas, and general conversations about Ozone +- **Slack**: For quick questions and real-time chat +- **Jira**: For tracking specific bugs, improvements, and feature requests +- **Community Meetings**: For synchronous discussions and getting to know the community + +All community channels follow the [Apache Code of Conduct](https://www.apache.org/foundation/policies/conduct.html) to ensure a welcoming and productive environment for everyone. --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
