From a255306c26d7b8eb558e052e818b7ec7438b9ea2 Mon Sep 17 00:00:00 2001 From: Roman Tsisyk Date: Mon, 30 Dec 2024 13:51:16 +0000 Subject: [PATCH] [docs] Update COMMUNICATION.md Signed-off-by: Roman Tsisyk --- docs/COMMUNICATION.md | 51 ++++++++++++++++++++++++++++++++++++------- 1 file changed, 43 insertions(+), 8 deletions(-) diff --git a/docs/COMMUNICATION.md b/docs/COMMUNICATION.md index 3bd3658e2b..fbf4ff06c1 100644 --- a/docs/COMMUNICATION.md +++ b/docs/COMMUNICATION.md @@ -1,17 +1,52 @@ # Communication -## Telegram Channel +Organic Maps is a mobile app for end-users, developed by the community. While some end-users may become contributors, and contributors obviously use the product, these roles typically represent separate areas of involvement. Separate communication channels are available for individuals seeking assistance with using the application and for those seeking help with contributions. -Please subscribe to our [Telegram Channel](https://t.me/OrganicMapsApp) for updates. +## Issues with the App -## Telegram Group +The preferred method for reporting an issue with the app is to file a GitHub Issue that clearly details the problem, including any relevant information or steps to reproduce the issue. This ensures that the issue is properly tracked and addressed by the team. If you encounter any difficulties using GitHub or need assistance with submitting the issue, please send a free-form email to support@organicmaps.app. The team will assist with triaging the issue and help guide you through the process. -Please join our [Telegram Group](https://t.me/OrganicMaps) to discuss with other users. +Channels in order of preference: -## GitHub Discussions +1. [GitHub Issues](https://github.com/organicmaps/organicmaps/issues/) +2. [Email](mailto:support@organicmaps.app) -If you have some ideas or want to request a new feature, please [start a discussion thread](https://github.com/organicmaps/organicmaps/discussions/categories/ideas). +## Issues with Development -## Code of Conduct +The preferred method for reporting a development issue is to file a GitHub Issue that clearly details the problem, including any relevant information or steps to reproduce the issue. This ensures that the issue is properly tracked and addressed by the team. If you are having trouble formulating the problem or providing sufficient details, please consider seeking help in the project’s communication channels, such as the community chat, where you can collaborate with other contributors or team members. This will help clarify the issue before submitting a GitHub Issue, ensuring that all necessary information is included for a more efficient resolution. -The Organic Maps community abides by the [CNCF code of conduct](CODE_OF_CONDUCT.md). +Channels in order of preference: + +1. [GitHub Issues](https://github.com/organicmaps/organicmaps/issues/) +2. [Zulip Workspace](https://organicmaps.zulipchat.com) + +## Feature Proposals + +The preferred method for submitting a feature proposal is to file a GitHub Issue that clearly outlines the proposed feature, its potential benefits, and any relevant context or use cases. This allows the team to review the suggestion and track its progress. When submitting a feature proposal, please provide as much detail as possible, including mockups, user stories, or examples that can help others understand the concept and its potential impact. + +If you're unsure how to present the proposal or need feedback before submitting, consider discussing it in the project’s communication channels, such as the community chat or forums. This will give you the opportunity to refine your idea based on input from other contributors or team members. Please note that proposals without a filed ticket will have little to no chance of being processed. + +Channels in order of preference: + +1. [GitHub Issues](https://github.com/organicmaps/organicmaps/issues/) +2. [Zulip Workspace](https://organicmaps.zulipchat.com) + +### Staying Up to Date as a User + +To stay informed about the latest updates and features, please consider subscribing to our social media channels, such as Mastodon. Following us will keep you updated on new releases, announcements, and important news. + +Channels in order of preference: + +1. [Mastodon page](https://mastodon.social/@organicmaps) +2. [Telegram Channel](https://t.me/OrganicMapsApp) (not a chat group!) + +### Staying Up to Date as a Contributor + +To stay informed about development updates, monitor announcements on GitHub Discussions and the General channel in Zulip for key information regarding the open-source project. + +Channels in order of preference: + +1. [#general on Zulip](https://organicmaps.zulipchat.com/#narrow/channel/409110-General) +2. [Announcements on GitHub Discussions](https://github.com/orgs/organicmaps/discussions/categories/announcements). + +## \ No newline at end of file -- 2.45.3