diff --git a/docs/contributing/communication.md b/docs/contributing/communication.md new file mode 100644 index 0000000000..3b6cb667b2 --- /dev/null +++ b/docs/contributing/communication.md @@ -0,0 +1,51 @@ +# Communication + +We welcome your feedback, questions and ideas. Here's how to reach the +community. + +## Code of Conduct +All communication and interactions in the Ansible Community are governed +by our `code_of_conduct`(https://docs.ansible.com/ansible/latest/community/code_of_conduct.html). Please read and +abide by it! Reach out to our community team at + if you have any questions or need +assistance. + +## Forum + +Join the [Ansible Forum](https://forum.ansible.com) as a single starting +point and our default communication platform for questions and help, +development discussions, events, and much more. +[Register](https://forum.ansible.com/signup?) to join the community. +Search by categories and tags to find interesting topics or start a new +one; subscribe only to topics you need! + +- [Get Help](https://forum.ansible.com/c/help/6): get help or help + others. Please add appropriate tags if you start new discussions, + for example `awx`, `operator`, and `documentation`. +- [Posts tagged with `awx`](https://forum.ansible.com/tag/awx): + subscribe to participate in project/technology-related + conversations. There are other related tags in the forum you can use. +- [Bullhorn + newsletter](https://docs.ansible.com/ansible/devel/community/communication.html#the-bullhorn): + used to announce releases and important changes. +- [Social Spaces](https://forum.ansible.com/c/chat/4): gather and + interact with fellow enthusiasts. +- [News & Announcements](https://forum.ansible.com/c/news/5): track + project-wide announcements including social events. + +For more information on the forum navigation, see [Navigating the +Ansible forum](https://forum.ansible.com/t/navigating-the-ansible-forum-tags-categories-and-concepts/39) +post. + +## Matrix + +For real-time interactions, conversations in the AWX community happen +over the Matrix protocol in the following channels: + +- [#awx:ansible.com](https://matrix.to/#/#awx:ansible.com): AWX + project-related discussions. +- [#docs:ansible.im](https://matrix.to/#/#docs:ansible.im): Ansible + and AWX documentation-related discussions. + +For more information, see the community-hosted [Matrix +FAQ](https://hackmd.io/@ansible-community/community-matrix-faq). diff --git a/docs/index.md b/docs/index.md index c749055313..178c578475 100644 --- a/docs/index.md +++ b/docs/index.md @@ -30,6 +30,7 @@ changelog Code Of Conduct contributing/guidelines +contributing/communication contributing/security Private unsupported (dev) API autodoc ```