95 lines
5.3 KiB
ReStructuredText
95 lines
5.3 KiB
ReStructuredText
.. _ansible_community_guide:
|
|
|
|
***********************
|
|
Ansible Community Guide
|
|
***********************
|
|
|
|
.. note::
|
|
|
|
**Making Open Source More Inclusive**
|
|
|
|
Red Hat is committed to replacing problematic language in our code, documentation, and web properties. We are beginning with these four terms: master, slave, blacklist, and whitelist. We ask that you open an issue or pull request if you come upon a term that we have missed. For more details, see `our CTO Chris Wright's message <https://www.redhat.com/en/blog/making-open-source-more-inclusive-eradicating-problematic-language>`_.
|
|
|
|
Welcome to the Ansible Community Guide!
|
|
|
|
The purpose of this guide is to teach you everything you need to know about being a contributing member of the Ansible community. All types of contributions are welcome and necessary to Ansible's continued success.
|
|
|
|
This page outlines the most common situations and questions that bring readers to this section. If you prefer a :ref:`traditional table of contents <community_toc>`, you can find one at the bottom of the page.
|
|
|
|
|
|
Getting started
|
|
===============
|
|
|
|
* I am new to the community. Where can I find the Ansible :ref:`code_of_conduct`?
|
|
* I would like to know what I am agreeing to when I contribute to Ansible. Does Ansible have a :ref:`contributor_license_agreement`?
|
|
* I would like to contribute but I am not sure how. Are there :ref:`easy ways to contribute <how_can_i_help>`?
|
|
* I want to talk to other Ansible users. How do I find an `Ansible Meetup near me <https://www.meetup.com/topics/ansible/>`_?
|
|
* I have a question. Which :ref:`Ansible email lists and IRC channels <communication>` will help me find answers?
|
|
* I want to learn more about Ansible. What can I do?
|
|
|
|
* `Read books <https://www.ansible.com/resources/ebooks>`_.
|
|
* `Get certified <https://www.ansible.com/products/training-certification>`_.
|
|
* `Attend events <https://www.ansible.com/community/events>`_.
|
|
* `Review getting started guides <https://www.ansible.com/resources/get-started>`_.
|
|
* `Watch videos <https://www.ansible.com/resources/videos>`_ - includes Ansible Automates, AnsibleFest & webinar recordings.
|
|
|
|
* I would like updates about new Ansible versions. How are `new releases announced <https://groups.google.com/forum/#!forum/ansible-announce>`_?
|
|
* I want to use the current release. How do I know which :ref:`releases are current <release_schedule>`?
|
|
|
|
Going deeper
|
|
============
|
|
|
|
* I think Ansible is broken. How do I :ref:`report a bug <reporting_bugs>`?
|
|
* I need functionality that Ansible does not offer. How do I :ref:`request a feature <request_features>`?
|
|
* How do I :ref:`contribute to an Ansible-maintained collection <contributing_maintained_collections>`?
|
|
* I am waiting for a particular feature. How do I see what is :ref:`planned for future Ansible Releases <roadmaps>`?
|
|
* I have a specific Ansible interest or expertise (for example, VMware, Linode, and so on). How do I get involved in a :ref:`working group <working_group_list>`?
|
|
* I would like to participate in conversations about features and fixes. How do I review GitHub issues and pull requests?
|
|
* I found a typo or another problem on docs.ansible.com. How can I :ref:`improve the documentation <community_documentation_contributions>`?
|
|
* Is there a :ref:`mailing list <communication>` I can sign up for to stay informed about Ansible?
|
|
|
|
|
|
Working with the Ansible repo
|
|
=============================
|
|
|
|
* I want to make my first code changes to a collection or to ``ansible-base``. How do I :ref:`set up my Python development environment <environment_setup>`?
|
|
* I would like to get more efficient as a developer. How can I find :ref:`editors, linters, and other tools <other_tools_and_programs>` that will support my Ansible development efforts?
|
|
* I want my code to meet Ansible's guidelines. Where can I find guidance on :ref:`coding in Ansible <developer_guide>`?
|
|
* I want to learn more about Ansible roadmaps, releases, and projects. How do I find information on :ref:`the development cycle <community_development_process>`?
|
|
* I would like to connect Ansible to a new API or other resource. How do I :ref:`create a collection <developing_modules_in_groups>`?
|
|
* My pull request is marked ``needs_rebase``. How do I :ref:`rebase my PR <rebase_guide>`?
|
|
* I am using an older version of Ansible and want a bug fixed in my version that has already been fixed on the ``devel`` branch. How do I :ref:`backport a bugfix PR <backport_process>`?
|
|
* I have an open pull request with a failing test. How do I learn about Ansible's :ref:`testing (CI) process <developing_testing>`?
|
|
* I am ready to step up as a collection maintainer. What are the :ref:`guidelines for maintainers <maintainers>`?
|
|
* A module in a collection I maintain is obsolete. How do I :ref:`deprecate a module <deprecating_modules>`?
|
|
|
|
.. _community_toc:
|
|
|
|
Traditional Table of Contents
|
|
=============================
|
|
|
|
If you prefer to read the entire Community Guide, here is a list of the pages in order:
|
|
|
|
.. toctree::
|
|
:maxdepth: 2
|
|
|
|
code_of_conduct
|
|
how_can_I_help
|
|
reporting_bugs_and_features
|
|
documentation_contributions
|
|
communication
|
|
development_process
|
|
contributing_maintained_collections
|
|
contributor_license_agreement
|
|
triage_process
|
|
other_tools_and_programs
|
|
../dev_guide/style_guide/index
|
|
|
|
.. toctree::
|
|
:caption: Guidelines for specific types of contributors
|
|
:maxdepth: 1
|
|
|
|
committer_guidelines
|
|
maintainers
|
|
release_managers
|
|
github_admins
|