This is an automated email from the ASF dual-hosted git repository.
ivandika pushed a commit to branch HDDS-9225-website-v2
in repository https://gitbox.apache.org/repos/asf/ozone-site.git
The following commit(s) were added to refs/heads/HDDS-9225-website-v2 by this
push:
new 003c8432 HDDS-9618. Add detailed communication channels page. (#134)
003c8432 is described below
commit 003c843241ed7845515d9242eab2f6489a50aba1
Author: Ritesh H Shukla <[email protected]>
AuthorDate: Mon Jul 14 07:46:38 2025 -0700
HDDS-9618. Add detailed communication channels page. (#134)
---
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]
