From 685cbaeded217f7e20434cd15731c9157ef4b367 Mon Sep 17 00:00:00 2001 From: Don Naro Date: Wed, 4 Sep 2024 15:47:49 +0100 Subject: [PATCH] Update community comms info (#712) As a part of the [Consolidating Ansible discussion platforms initiative](https://forum.ansible.com/t/proposal-consolidating-ansible-discussion-platforms/6812), this PR adds the communication section template defined by the community to the README and the docsite. Similar PRs are now being raised across all the Ansible ecosystem projects. Thanks! --- README.rst | 5 +++-- docs/contributing.rst | 23 ++++++++++++++++------- 2 files changed, 19 insertions(+), 9 deletions(-) diff --git a/README.rst b/README.rst index d1b8d1a4..dcb53686 100644 --- a/README.rst +++ b/README.rst @@ -67,15 +67,16 @@ Documentation =============== Please refer to the `Getting Started guide `_ to get started with ``ansible-rulebook``. - =============== Contributing =============== We ask all of our community members and contributors to adhere to the `Ansible code of conduct `_. If you have questions or need assistance, please reach out to our community team at codeofconduct@ansible.com -Refer to the Contributing guide to get started developing, reporting bugs or providing feedback. +Refer to the `Contributing guide `_ to get started developing, reporting bugs or providing feedback. +To find out how to join the community and get in touch, see the `Community `_ section of our docs. +You can also find more information in the `Ansible communication guide `_. Credits ------- diff --git a/docs/contributing.rst b/docs/contributing.rst index 641ecb14..f8074fdc 100644 --- a/docs/contributing.rst +++ b/docs/contributing.rst @@ -5,11 +5,26 @@ Contributing Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given. -You can contribute in many ways: +Getting in touch +---------------- + +Join the `Ansible Forum `_, the 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 `ansible-rulebook`. +* `Posts tagged with 'ansible-rulebook' `_: subscribe to participate in project-related conversations. +* `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. + +See `Navigating the Ansible forum `_ for some practical advice on finding your way around. Types of Contributions ---------------------- +You can contribute in many ways: + Report Bugs ~~~~~~~~~~~ @@ -27,8 +42,6 @@ Fix Bugs Look through the GitHub issues for bugs. Anything tagged with "bug" and "help wanted" is open to whoever wants to implement it. - - Implement Features ~~~~~~~~~~~~~~~~~~ @@ -67,7 +80,3 @@ If you are proposing a feature: * Keep the scope as narrow as possible, to make it easier to implement. * Remember that this is a volunteer-driven project, and that contributions are welcome :) - - -Also you can check the `Matrix chat `__, or via the -event-driven-automation@redhat.com email.