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/contributor/communication.rst b/docs/contributor/communication.rst deleted file mode 100644 index 9dd8f59b99..0000000000 --- a/docs/contributor/communication.rst +++ /dev/null @@ -1,39 +0,0 @@ -.. _communication: - -Communication -============= - -We welcome your feedback, questions and ideas. Here's how to reach the community. - -.. _code_of_conduct: - -Code of Conduct ---------------- - -All communication and interactions in the Ansible Community are governed by our :ref:`code_of_conduct`. Please read and abide by it! -Reach out to our community team at `codeofconduct@ansible.com `_ if you have any questions or need assistance. - -.. _forum: - -Forum ------ - -Join the `Ansible Forum `_ as a single starting point and our default communication platform for questions and help, development discussions, events, and much more. `Register `_ 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 `_: get help or help others. Please add appropriate tags if you start new discussions, for example `awx`, `ee`, and `documentation`. -* `Posts tagged with 'awx' `_: subscribe to participate in project/technology-related conversations. There are other related tags in the forum you can use. -* `Bullhorn newsletter `_: used to announce releases and important changes. -* `Social Spaces `_: gather and interact with fellow enthusiasts. -* `News & Announcements `_: track project-wide announcements including social events. - -For more information on the forum navigation, see `Navigating the Ansible forum `_ post. - -Matrix ------- - -For real-time interactions, conversations in the AWX community happen over the Matrix protocol in the following channels: - -* `#awx:ansible.com `_: AWX project-related discussions. -* `#docs:ansible.im `_: Ansible and AWX documentation-related discussions. - -For more information, see the community-hosted `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 ```