Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Communication: add the guide, update README #708

Merged
merged 10 commits into from
Sep 4, 2024
14 changes: 6 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,22 +14,20 @@ https://ansible-builder.readthedocs.io/en/stable/

## Get Involved:

* We welcome your feedback, questions and ideas.
See our [Communication guide](https://ansible.readthedocs.io/projects/builder/en/latest/installation/)
to learn how to join the conversation.
* We use [GitHub issues](https://github.com/ansible/ansible-builder/issues) to
track bug reports and feature ideas
* Want to contribute, check out our [guide](CONTRIBUTING.md)
* Join us in the `#ansible-builder` channel on Libera.chat IRC
* For the full list of Ansible email Lists, IRC channels and working groups,
check out the [Ansible Mailing
lists](https://docs.ansible.com/ansible/latest/community/communication.html#mailing-list-information)
page of the official Ansible documentation.
track bug reports and feature ideas.
* Want to contribute, check out our [guide](CONTRIBUTING.md).

## Code of Conduct

We ask all of our community members and contributors to adhere to the [Ansible
code of
conduct](http://docs.ansible.com/ansible/latest/community/code_of_conduct.html). If
you have questions, or need assistance, please reach out to our community team
at [codeofconduct@ansible.com](mailto:codeofconduct@ansible.com)
at [codeofconduct@ansible.com](mailto:codeofconduct@ansible.com).

## License

Expand Down
31 changes: 31 additions & 0 deletions docs/communication.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
.. _communication:

*************
Communication
Andersson007 marked this conversation as resolved.
Show resolved Hide resolved
*************

We welcome your feedback, questions and ideas. Here's how to reach the community.

Code of Conduct
===============

All communication and interactions in the Ansible Builder community are governed by the `Ansible code of conduct <https://docs.ansible.com/ansible/devel/community/code_of_conduct.html>`_. Please read and abide by it!
Reach out to our community team at `codeofconduct@ansible.com <mailto:codeofconduct@ansible.com>`_ if you have any questions or need assistance.

Forum
=====
Andersson007 marked this conversation as resolved.
Show resolved Hide resolved

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!
Andersson007 marked this conversation as resolved.
Show resolved Hide resolved

* `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 `ansible-builder`, `ee`, and `documentation`.
* `Posts tagged with 'ansible-builder' <https://forum.ansible.com/tag/ansible-builder>`_: subscribe to participate in project-related conversations.
* `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.

Libera.Chat IRC
===============

Real-time conversations happen in the ``#ansible-builder`` Libera.Chat IRC channel.
5 changes: 5 additions & 0 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,10 @@ These containers are known as execution environments. You can use them on AWX or
You can design and distribute specialized execution environments for your Ansible content, choosing the versions of Python and
ansible-core you want, and installing only the Python packages, system packages, and Ansible collections you need for your tasks.

.. note::

Need help or want to discuss Ansible Builder including the documentation? See the :ref:`Communication guide<communication>` to learn how to join the conversation!
Andersson007 marked this conversation as resolved.
Show resolved Hide resolved

.. contents::
:local:

Expand Down Expand Up @@ -105,6 +109,7 @@ Collection maintainers can learn to correctly declare dependencies for their col
:caption: Contents:

self
communication
Andersson007 marked this conversation as resolved.
Show resolved Hide resolved
installation
definition
usage
Expand Down
Loading