From ee582728a15db423c165e4a6bada62fe9adbfd0d Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Wed, 3 Jul 2024 11:18:02 +0200 Subject: [PATCH 01/19] communication guide: overhaul --- docs/docsite/rst/community/communication.rst | 104 ++++--------------- 1 file changed, 18 insertions(+), 86 deletions(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index 5d8dfbc42f5..aa8157af05e 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -17,7 +17,7 @@ All communication and interactions in the Ansible Community are governed by our Forum ===== -The `Ansible Community Forum `_ is a single starting point 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! +The `Ansible Community Forum `_ is 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! Take a look at the `forum groups `_ and join ones that match your interests. In most cases, joining a forum group automatically subscribes you to related posts. @@ -30,98 +30,51 @@ Request it in the `forum topic `_ or any other Matrix homeserver) * a `Matrix client `_ (we recommend `Element Webchat `_) The Ansible community maintains its own Matrix homeserver at ``ansible.im``, however, public registration is currently unavailable. -Matrix chat supports: - -* persistence (when you log on, you see all messages since you last logged off) -* edits (Let you fix typos and so on. **NOTE** Each edit you make on Matrix re-sends the message to IRC. Please try to avoid multiple edits!) -* replies to individual users -* reactions/emojis -* bridging to IRC -* no line limits -* images - The room links in the :ref:`general_channels` or the :ref:`working_group_list` list will take you directly to the relevant rooms. - -If there is no appropriate room for your community, please create it. +If there is no appropriate room for your community, please create it if needed. For more information, see the community-hosted `Matrix FAQ `_. You can add Matrix shields to your repository's ``README.md`` using the shield in the `community-topics `_ repository as a template. -Ansible community on IRC ------------------------- - -The Ansible community maintains several IRC channels on `irc.libera.chat `_. To join the community using IRC, you need one thing: - -* an IRC client - -IRC chat supports: - -* no persistence (you only see messages when you are logged on unless you add a bouncer) -* simple text interface -* bridging from Matrix - -Our IRC channels may require you to register your IRC nickname. If you receive an error when you connect or when posting a message, see `libera.chat's Nickname Registration guide `_ for instructions. To find all ``ansible`` specific channels on the libera.chat network, use the following command in your IRC client: - -.. code-block:: text - - /msg alis LIST #ansible* -min 5 - -as described in the `libera.chat docs `_. - -Our channels record history on the Matrix side. The channel history can be viewed in a browser - all channels will report an appropriate link to ``chat.ansible.im`` in their Chanserv entrymsg upon joining the room. Alternatively, a URL of the form ``https://chat.ansible.im/#/room/# {IRC channel name}:libera.chat`` will also work, for example - for the #ansible-docs channel it would be `https://app.element.io/#/room/#ansible-docs:libera.chat`. +.. note:: -.. _general_channels: + The IRC channels are not considered official communication channels anymore. Please use the Forum and Matrix instead. General channels ---------------- The clickable links will take you directly to the relevant Matrix room in your browser; room/channel information is also given for use in other clients: -- `Community social room and posting news for the Bullhorn newsletter `_ - ``Matrix: #social:ansible.com | IRC: #ansible-social`` -- `General usage and support questions `_ - ``Matrix: #users:ansible.com | IRC: #ansible`` -- `Discussions on developer topics and code related to features or bugs `_ - ``Matrix: #devel:ansible.com | IRC: #ansible-devel`` -- `Discussions on community and collections related topics `_ - ``Matrix: #community:ansible.com | IRC: #ansible-community`` -- `For public community meetings `_ - ``Matrix: #meeting:ansible.im | IRC: #ansible-meeting`` - - We will generally announce these on one or more of the above mailing lists. See the `meeting schedule `_ +- `Community social room and posting news for the Bullhorn newsletter `_ +- `General usage and support questions `_ +- `Discussions on developer topics and code related to features or bugs `_ +- `Discussions on community and collections related topics `_ +- `For public community meetings `_ Working group-specific channels ------------------------------- Many of the working groups have dedicated chat channels. See the :ref:`working_group_list` for more information. -Regional and Language-specific channels ---------------------------------------- - -- Comunidad Ansible en español - Matrix: `#espanol:ansible.im `_ | IRC: ``#ansible-es`` -- Communauté française d'Ansible - Matrix: `#francais:ansible.im `_ | IRC: ``#ansible-fr`` -- Communauté suisse d'Ansible - Matrix: `#suisse:ansible.im `_ | IRC: ``#ansible-zh`` -- European Ansible Community - Matrix: `#europe:ansible.im `_ | IRC: ``#ansible-eu`` - Meetings on chat ---------------- -The Ansible community holds regular meetings on various topics on Matrix/IRC, and anyone who is interested is invited to participate. For more information about Ansible meetings, consult the `meeting schedule and agenda page `_. +The Ansible community holds regular meetings on various topics on Matrix, and anyone who is interested is invited to participate. +For more information about Ansible meetings, consult the `meeting schedule and agenda page `_. .. _working_group_list: @@ -130,27 +83,24 @@ Working groups Working Groups are a way for Ansible community members to self-organize around particular topics of interest. -Our community working groups are represented in `Matrix rooms `_ and `Forum groups `_. +Our community working groups are represented in `Forum groups `_ and additionally in `Matrix rooms `_. See those links for a complete list of communications channels. -Many of them meet in chat. If you want to get involved in a working group, join the Matrix room or IRC channel where it meets or comment on the agenda. - - Forming a new working group ---------------------------- The basic components of a working group are: +* Dedicated `forum group `_. * Group name and charter (why the group exists). -* Registered :ref:`real-time chat channel`. * Group of users (at least two!) who will be driving the agenda of the working group. -* Dedicated `forum group `_. +* [If needed] Registered :ref:`real-time chat channel`. The basic responsibilities of a working group are: * Follow the :ref:`code_of_conduct`. -* Be responsive on your real-time chat channel. * Be responsive on the `forum `_ in related topics. +* Be responsive on your real-time chat channel otherwise shut it down. * Report semi-regularly on the cool stuff that your working group is working on. * Keep your forum group information updated. @@ -208,21 +158,3 @@ in the `Ansible Social room on Matrix, the next weekly issue. Read past issues of `the Bullhorn `_. - -Asking questions over email -=========================== - -.. note:: - - This form of communication is deprecated. Consider using the :ref:`ansible_forum` instead. - -Your first post to the mailing list will be moderated (to reduce spam), so please allow up to a day or so for your first post to appear. - -* `Ansible Announce list `_ is a read-only list that shares information about new releases of Ansible, and also rare infrequent event information, such as announcements about an upcoming AnsibleFest, which is our official conference series. Worth subscribing to! -* `Ansible AWX List `_ is for `Ansible AWX `_ -* `Ansible Development List `_ is for questions about developing Ansible modules (mostly in Python), fixing bugs in the Ansible Core code, asking about prospective feature design, or discussions about extending Ansible or features in progress. -* `Ansible Outreach List `_ help with promoting Ansible and `Ansible Meetups `_ -* `Ansible Project List `_ is for sharing Ansible tips, answering questions about playbooks and roles, and general user discussion. -* `Molecule Discussions `_ is designed to aid with the development and testing of Ansible roles with Molecule. - -The Ansible mailing lists are hosted on Google, but you do not need a Google account to subscribe. To subscribe to a group from a non-Google account, send an email to the subscription address requesting the subscription. For example: ``ansible-devel+subscribe@googlegroups.com``. From c09fb81ee3b321f1e3b0715dfcb13fc603dc8223 Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Wed, 3 Jul 2024 19:44:55 +0200 Subject: [PATCH 02/19] Update docs/docsite/rst/community/communication.rst Co-authored-by: Don Naro --- docs/docsite/rst/community/communication.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index aa8157af05e..28edf8d2a57 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -36,7 +36,7 @@ For real-time interactions, conversations in the Ansible community happen over t The :ref:`ansible_forum` is our default communication platform. Make sure you joined and use it before considering other options like Matrix. -Join a channel any time to chat with fellow enthusiasts, participate in a Working Group meeting, or just say hello. To do it, you need: +Join a channel any time to chat with fellow enthusiasts, participate in a Working Group meeting, or just say hello. To chat on Matrix, you need: * a Matrix account (from `Matrix.org `_ or any other Matrix homeserver) * a `Matrix client `_ (we recommend `Element Webchat `_) From 40b3a0badcaddd9ac51c85cd5d0b14067f32c014 Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Wed, 3 Jul 2024 19:45:06 +0200 Subject: [PATCH 03/19] Update docs/docsite/rst/community/communication.rst Co-authored-by: Don Naro --- docs/docsite/rst/community/communication.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index 28edf8d2a57..00e21bb6a87 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -52,7 +52,7 @@ You can add Matrix shields to your repository's ``README.md`` using the shield i .. note:: - The IRC channels are not considered official communication channels anymore. Please use the Forum and Matrix instead. + IRC channels are no longer considered official communication channels. Please use the Forum and Matrix instead. General channels ---------------- From 6555644c34cffc1103a4c422158e4a57b2d7fb3f Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Wed, 3 Jul 2024 19:45:26 +0200 Subject: [PATCH 04/19] Update docs/docsite/rst/community/communication.rst Co-authored-by: Don Naro --- docs/docsite/rst/community/communication.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index 00e21bb6a87..600cdcba0c2 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -34,7 +34,7 @@ For real-time interactions, conversations in the Ansible community happen over t .. note:: - The :ref:`ansible_forum` is our default communication platform. Make sure you joined and use it before considering other options like Matrix. + The :ref:`ansible_forum` is our default communication platform. Join the forum and get in touch with the community there before considering other options like Matrix. Join a channel any time to chat with fellow enthusiasts, participate in a Working Group meeting, or just say hello. To chat on Matrix, you need: From 36026ef19aa34b950f025acfec88a3e099706481 Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Wed, 3 Jul 2024 19:47:49 +0200 Subject: [PATCH 05/19] Update docs/docsite/rst/community/communication.rst Co-authored-by: John Barker --- docs/docsite/rst/community/communication.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index 600cdcba0c2..e7fd0f66928 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -70,7 +70,7 @@ Working group-specific channels Many of the working groups have dedicated chat channels. See the :ref:`working_group_list` for more information. -Meetings on chat +Meetings on Matrix ---------------- The Ansible community holds regular meetings on various topics on Matrix, and anyone who is interested is invited to participate. From 546b13d9932432e1ff19c7acc1a6f29a32562f6a Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Wed, 3 Jul 2024 19:50:18 +0200 Subject: [PATCH 06/19] Fix title --- docs/docsite/rst/community/communication.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index e7fd0f66928..89a3387b822 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -71,7 +71,7 @@ Working group-specific channels Many of the working groups have dedicated chat channels. See the :ref:`working_group_list` for more information. Meetings on Matrix ----------------- +------------------ The Ansible community holds regular meetings on various topics on Matrix, and anyone who is interested is invited to participate. For more information about Ansible meetings, consult the `meeting schedule and agenda page `_. From b6db56b8e2e2c87d2be9fe12a622ee1e622a47a8 Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Thu, 4 Jul 2024 07:24:03 +0200 Subject: [PATCH 07/19] Update docs/docsite/rst/community/communication.rst Co-authored-by: Sandra McCann --- docs/docsite/rst/community/communication.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index 89a3387b822..b31ded604da 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -83,7 +83,7 @@ Working groups Working Groups are a way for Ansible community members to self-organize around particular topics of interest. -Our community working groups are represented in `Forum groups `_ and additionally in `Matrix rooms `_. +Our community working groups are represented in `Forum groups . See those links for a complete list of communications channels. Forming a new working group From f6d49bdae192817ca88f7277148a9051432d4e74 Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Thu, 4 Jul 2024 07:26:42 +0200 Subject: [PATCH 08/19] Fix --- docs/docsite/rst/community/communication.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index b31ded604da..a4b11e31ae1 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -83,7 +83,7 @@ Working groups Working Groups are a way for Ansible community members to self-organize around particular topics of interest. -Our community working groups are represented in `Forum groups . +Our community working groups are represented in `Forum groups `. See those links for a complete list of communications channels. Forming a new working group From 0a1ff58329ecf895e7cd96f118a1355f26f4eba0 Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Thu, 4 Jul 2024 07:40:11 +0200 Subject: [PATCH 09/19] Remove suggestion to create a matrix channel --- docs/docsite/rst/community/communication.rst | 3 --- 1 file changed, 3 deletions(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index a4b11e31ae1..c67d31ba617 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -41,10 +41,7 @@ Join a channel any time to chat with fellow enthusiasts, participate in a Workin * a Matrix account (from `Matrix.org `_ or any other Matrix homeserver) * a `Matrix client `_ (we recommend `Element Webchat `_) -The Ansible community maintains its own Matrix homeserver at ``ansible.im``, however, public registration is currently unavailable. - The room links in the :ref:`general_channels` or the :ref:`working_group_list` list will take you directly to the relevant rooms. -If there is no appropriate room for your community, please create it if needed. For more information, see the community-hosted `Matrix FAQ `_. From eeadb8ceefa9e60148ceedac2f7159057c527eb4 Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Thu, 4 Jul 2024 08:35:39 +0200 Subject: [PATCH 10/19] Reorganize WG section --- docs/docsite/rst/community/communication.rst | 35 +++++--------------- 1 file changed, 8 insertions(+), 27 deletions(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index c67d31ba617..e20987af030 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -83,39 +83,20 @@ Working Groups are a way for Ansible community members to self-organize around p Our community working groups are represented in `Forum groups `. See those links for a complete list of communications channels. -Forming a new working group ----------------------------- +Requesting a forum group +-------------------------- -The basic components of a working group are: +To request a new working group: -* Dedicated `forum group `_. -* Group name and charter (why the group exists). -* Group of users (at least two!) who will be driving the agenda of the working group. -* [If needed] Registered :ref:`real-time chat channel`. - -The basic responsibilities of a working group are: - -* Follow the :ref:`code_of_conduct`. -* Be responsive on the `forum `_ in related topics. -* Be responsive on your real-time chat channel otherwise shut it down. -* Report semi-regularly on the cool stuff that your working group is working on. -* Keep your forum group information updated. - - -Requesting a working group -^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Anyone can request to start a Working Group, for any reason. - -If you need only a `Forum group `_, -request it in the `forum topic `_. - -If you also need a real-time chat channel, you can `request one `_. +* Check if there is no appropriate `Forum group `_ you can join instead of starting a new one. +* See the `things you can ask for `_ with respect to working groups. +* Request a group in the `forum topic `. +* If you also need a Matrix chat channel, see the `Ansible Community Matrix FAQ `_. .. _request_coll_repo: Requesting a community collection repository -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +-------------------------------------------- Working groups are often built around Ansible community collections. You can use a repository under your organization or request one under `ansible-collections `_ on the forum by creating a topic in the `Project Discussions category and the coll-repo-request tag `_. From e4cefd2bb0b738dd9d9154847eee7459b002ba69 Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Thu, 4 Jul 2024 08:40:12 +0200 Subject: [PATCH 11/19] Remove request a forum group call from the Forum section --- docs/docsite/rst/community/communication.rst | 3 --- 1 file changed, 3 deletions(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index e20987af030..a4920fff697 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -22,9 +22,6 @@ The `Ansible Community Forum `_ is a single starting Take a look at the `forum groups `_ and join ones that match your interests. In most cases, joining a forum group automatically subscribes you to related posts. -Want to create a group? -Request it in the `forum topic `_. - .. _communication_irc: Real-time chat From 25a2366dc514cadcda9850723dd75dcb09364dea Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Thu, 4 Jul 2024 08:59:45 +0200 Subject: [PATCH 12/19] Remove meetings Matrix chat --- docs/docsite/rst/community/communication.rst | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index a4920fff697..db98dd84117 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -57,7 +57,6 @@ The clickable links will take you directly to the relevant Matrix room in your b - `General usage and support questions `_ - `Discussions on developer topics and code related to features or bugs `_ - `Discussions on community and collections related topics `_ -- `For public community meetings `_ Working group-specific channels ------------------------------- From 96f62b21ede94b8eb8c578467d08a18818229359 Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Thu, 4 Jul 2024 09:46:39 +0200 Subject: [PATCH 13/19] Bullhorn section: move, rewrite --- docs/docsite/rst/community/communication.rst | 22 ++++++++------------ 1 file changed, 9 insertions(+), 13 deletions(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index db98dd84117..5a6af963e1d 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -22,6 +22,15 @@ The `Ansible Community Forum `_ is a single starting Take a look at the `forum groups `_ and join ones that match your interests. In most cases, joining a forum group automatically subscribes you to related posts. +The Bullhorn +------------ + +**The Bullhorn** is our newsletter for the Ansible contributor community published in the Forum: + +* To subscribe, click the ``bell`` button under the `Bullhorn category `_ description and then ``Watching``. +* To publish your news item, see the `About the Newsletter category post `_. +* Questions about the newsletter? Ask us in the `Ansible Social room on Matrix`_. + .. _communication_irc: Real-time chat @@ -119,16 +128,3 @@ Ansible Automation Platform support questions Red Hat Ansible `Automation Platform `_ is a subscription that contains support, certified content, and tooling for Ansible including content management, a controller, UI and REST API. If you have a question about Ansible Automation Platform, visit `Red Hat support `_ rather than using a chat channel or the general project mailing list. - -The Bullhorn -============ - -**The Bullhorn** is our newsletter for the Ansible contributor community. You can get Bullhorn updates -from the :ref:`ansible_forum`. - -If you have any questions or content you would like to share, you are welcome to chat with us -in the `Ansible Social room on Matrix, and mention -`newsbot `_ to have your news item tagged for review for -the next weekly issue. - -Read past issues of `the Bullhorn `_. From adc00c49acc164c232661b38d84aab04d821e6d0 Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Thu, 4 Jul 2024 09:58:12 +0200 Subject: [PATCH 14/19] Reorganize Community topics section --- docs/docsite/rst/community/communication.rst | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index 5a6af963e1d..b9bff418143 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -112,15 +112,11 @@ Ansible Community Topics The :ref:`Ansible Community Steering Committee` uses the :ref:`ansible_forum` to asynchronously discuss with the Community and vote on Community topics. -Create a `new topic `_ if you want to discuss an idea that impacts any of the following: +For more information, see: -* Ansible Community -* Community collection best practices and :ref:`requirements` -* :ref:`Community collection inclusion policy` -* :ref:`The Community governance` -* Other proposals of importance that need the Committee or overall Ansible community attention - -See the `Community topics workflow `_ to learn more. +* :ref:`creating_community_topic` +* :ref:`community_topics_workflow` +* `Community topics on the Forum `_ Ansible Automation Platform support questions ============================================= From 658914548c714f6de52f90ed7531a48915553a5e Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Thu, 4 Jul 2024 10:00:09 +0200 Subject: [PATCH 15/19] Fix formatting --- docs/docsite/rst/community/communication.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index b9bff418143..def0f15868c 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -29,7 +29,7 @@ The Bullhorn * To subscribe, click the ``bell`` button under the `Bullhorn category `_ description and then ``Watching``. * To publish your news item, see the `About the Newsletter category post `_. -* Questions about the newsletter? Ask us in the `Ansible Social room on Matrix`_. +* Questions about the newsletter? Ask us in the `Ansible Social room on Matrix `_. .. _communication_irc: From 6d3cb864b54a6789c2afd9a27dedeba1c5d47819 Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Thu, 4 Jul 2024 10:01:33 +0200 Subject: [PATCH 16/19] Update docs/docsite/rst/community/communication.rst Co-authored-by: John Barker --- docs/docsite/rst/community/communication.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index def0f15868c..69422cb06ed 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -85,7 +85,7 @@ Working groups Working Groups are a way for Ansible community members to self-organize around particular topics of interest. -Our community working groups are represented in `Forum groups `. +Our community working groups are represented in `Forum groups `_. See those links for a complete list of communications channels. Requesting a forum group From e7edabf164b81cdfa7a83fa4e5ef416e34cd3ff9 Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Thu, 4 Jul 2024 10:01:43 +0200 Subject: [PATCH 17/19] Update docs/docsite/rst/community/communication.rst Co-authored-by: John Barker --- docs/docsite/rst/community/communication.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index 69422cb06ed..8a920118afe 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -17,7 +17,7 @@ All communication and interactions in the Ansible Community are governed by our Forum ===== -The `Ansible Community Forum `_ is 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! +The `Ansible Forum `_ is 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! Take a look at the `forum groups `_ and join ones that match your interests. In most cases, joining a forum group automatically subscribes you to related posts. From e9b60a1157978edd927cb6e0c407dd876adf7148 Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Thu, 4 Jul 2024 10:01:53 +0200 Subject: [PATCH 18/19] Update docs/docsite/rst/community/communication.rst Co-authored-by: John Barker --- docs/docsite/rst/community/communication.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index 8a920118afe..6f6c527d2dc 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -95,7 +95,7 @@ To request a new working group: * Check if there is no appropriate `Forum group `_ you can join instead of starting a new one. * See the `things you can ask for `_ with respect to working groups. -* Request a group in the `forum topic `. +* Request a group in the `forum topic `_. * If you also need a Matrix chat channel, see the `Ansible Community Matrix FAQ `_. .. _request_coll_repo: From 8c5ee39ab57267c51734891b14746e47ef033f1a Mon Sep 17 00:00:00 2001 From: Andrew Klychkov Date: Thu, 4 Jul 2024 10:53:39 +0200 Subject: [PATCH 19/19] Add a section about languages --- docs/docsite/rst/community/communication.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/docsite/rst/community/communication.rst b/docs/docsite/rst/community/communication.rst index 6f6c527d2dc..a8d4e4ba5be 100644 --- a/docs/docsite/rst/community/communication.rst +++ b/docs/docsite/rst/community/communication.rst @@ -31,6 +31,13 @@ The Bullhorn * To publish your news item, see the `About the Newsletter category post `_. * Questions about the newsletter? Ask us in the `Ansible Social room on Matrix `_. +Regional and Language-specific channels +--------------------------------------- + +If you feel more comfortable communicating in another language other than English, see the `International Communities forum category `_. Currently there are subcategories for Español (Spanish), Português (Portuguese), and Norsk (Norwegian). + +For more information including how to request a subcategory for a language, see the `About the International Communities category post `_. + .. _communication_irc: Real-time chat