43e0aa5b57
* Add dual index pages for roadmaps (part of #71566) (cherry picked from commitb518a5db14) * Docsite: replace Latin phrases to English (#71588) Replace Latin phrases like "e.g." and "i.e." and "etc." with English phrases. * Update docs/docsite/rst/community/committer_guidelines.rst * Update docs/docsite/rst/dev_guide/developing_modules_documenting.rst * Update docs/docsite/rst/dev_guide/developing_program_flow_modules.rst * Update docs/docsite/rst/dev_guide/module_lifecycle.rst * Update docs/docsite/rst/user_guide/intro_inventory.rst * Update docs/docsite/rst/user_guide/playbooks_loops.rst * Update docs/docsite/rst/user_guide/playbooks_reuse.rst * Update docs/docsite/rst/dev_guide/platforms/aws_guidelines.rst * Update docs/docsite/rst/dev_guide/testing.rst * Update docs/docsite/rst/dev_guide/testing_integration.rst * Update docs/docsite/rst/porting_guides/porting_guide_2.5.rst * Update docs/docsite/rst/reference_appendices/faq.rst (cherry picked from commit7bfeed3e24) * fix index page and TOCs * adds old roadmap index * adds toctree ref for old roadmaps Co-authored-by: Sandra McCann <samccann@redhat.com> Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru> Co-authored-by: Alicia Cozine <acozine@users.noreply.github.com>
88 lines
4.8 KiB
ReStructuredText
88 lines
4.8 KiB
ReStructuredText
.. _ansible_community_guide:
|
|
|
|
***********************
|
|
Ansible Community Guide
|
|
***********************
|
|
|
|
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>`?
|
|
|
|
|
|
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
|