diff options
author | Dag Wieers <dag@wieers.com> | 2019-04-04 23:41:53 +0200 |
---|---|---|
committer | Alicia Cozine <879121+acozine@users.noreply.github.com> | 2019-04-04 23:41:53 +0200 |
commit | e6aff4dc3b70b22f5d80ad1c1ad87f513a94858a (patch) | |
tree | f9d18b75d1dd17a3e0d7e7de4c2734111d35abbf /README.rst | |
parent | openssl_certificate now has cryptography backend (#53924). (#54880) (diff) | |
download | ansible-e6aff4dc3b70b22f5d80ad1c1ad87f513a94858a.tar.xz ansible-e6aff4dc3b70b22f5d80ad1c1ad87f513a94858a.zip |
Reduce ansible/ansible README to essentials (#52878)
* Reduce intro to essentials
Diffstat (limited to 'README.rst')
-rw-r--r-- | README.rst | 71 |
1 files changed, 28 insertions, 43 deletions
diff --git a/README.rst b/README.rst index 7f66765f1e..e830c95220 100644 --- a/README.rst +++ b/README.rst @@ -5,23 +5,9 @@ Ansible ******* Ansible is a radically simple IT automation system. It handles -configuration-management, application deployment, cloud provisioning, -ad-hoc task-execution, and multinode orchestration -- including -trivializing things like zero-downtime rolling updates with load -balancers. - -Read the documentation and more at https://ansible.com/ - -You can find installation instructions -`here <https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html>`_ for a -variety of platforms. - -Most users should probably install a released version of Ansible from ``pip``, a package manager or -our `release repository <https://releases.ansible.com/ansible/>`_. `Officially supported -<https://www.ansible.com/ansible-engine>`_ builds of Ansible are also available. Some power users -run directly from the development branch - while significant efforts are made to ensure that -``devel`` is reasonably stable, you're more likely to encounter breaking changes when running -Ansible this way. +configuration management, application deployment, cloud provisioning, +ad-hoc task execution, network automation, and multi-node orchestration. Ansible makes complex +changes like zero-downtime rolling updates with load balancers easy. More information on `the Ansible website <https://ansible.com/>`_. Design Principles ================= @@ -39,6 +25,21 @@ Design Principles * Be usable as non-root. * Be the easiest IT automation system to use, ever. +Use Ansible +=========== + +You can install a released version of Ansible via ``pip``, a package manager, or +our `release repository <https://releases.ansible.com/ansible/>`_. See our +`installation guide <https://docs.ansible.com/ansible/latest/installation_guide/intro_installation.html>`_ for details on installing Ansible +on a variety of platforms. + +Red Hat offers supported builds of `Ansible Engine <https://www.ansible.com/ansible-engine>`_. + +Power users and developers can run the ``devel`` branch, which has the latest +features and fixes, directly. Although it is reasonably stable, you are more likely to encounter +breaking changes when running the ``devel`` branch. We recommend getting involved +in the Ansible community if you want to run the ``devel`` branch. + Get Involved ============ @@ -47,51 +48,35 @@ Get Involved kinds of ways to contribute to and interact with the project, including mailing list information and how to submit bug reports and code to Ansible. -* All code submissions are done through pull requests to the ``devel`` branch. -* Feel free to talk to us before making larger changes +* Join a `Working Group + <https://github.com/ansible/community/wiki>`_, an organized community devoted to a specific technology domain or platform. +* Submit proposed a code update through a pull request to the ``devel`` branch. +* Talk to us before making larger changes to avoid duplicate efforts. This not only helps everyone - know what's going on, it also helps save time and effort if we decide + know what is going on, it also helps save time and effort if we decide some changes are needed. -* Users list: - `ansible-project <https://groups.google.com/group/ansible-project>`_ -* Development list: - `ansible-devel <https://groups.google.com/group/ansible-devel>`_ -* Announcement list: - `ansible-announce <https://groups.google.com/group/ansible-announce>`_ - -- read only -* irc.freenode.net: #ansible -* For the full list of Email Lists, IRC channels see the +* For a list of email lists, IRC channels and Working Groups, see the `Communication page <https://docs.ansible.com/ansible/latest/community/communication.html>`_ Branch Info =========== -* Releases are named after Led Zeppelin songs. (Releases prior to 2.0 - were named after Van Halen songs.) -* The ``devel`` branch corresponds to the release actively under - development. -* The ``stable-2.x`` branches exist for current releases. -* Various release-X.Y branches exist for previous releases. +* The ``devel`` branch corresponds to the release actively under development. +* The ``stable-2.X`` branches correspond to stable releases. * For information about the active branches see the `Ansible release and maintenance <https://docs.ansible.com/ansible/latest/reference_appendices/release_and_maintenance.html>`_ page. -* We'd love to have your contributions, read the `Community - Guide <https://docs.ansible.com/ansible/latest/community>`_ for notes on - how to get started. Roadmap ======= -Based on team and community feedback, an initial roadmap will be published for a major or minor version (ex: 2.0, 2.1). -Subminor versions will generally not have roadmaps published. - +Based on team and community feedback, an initial roadmap will be published for a major or minor version (ex: 2.7, 2.8). The `Ansible Roadmap page <https://docs.ansible.com/ansible/devel/roadmap/>`_ details what is planned and how to influence the roadmap. Authors ======= Ansible was created by `Michael DeHaan <https://github.com/mpdehaan>`_ -(michael.dehaan/gmail/com) and has contributions from over 4000 users -(and growing). Thanks everyone! +and has contributions from over 4000 users (and growing). Thanks everyone! `Ansible <https://www.ansible.com>`_ is sponsored by `Red Hat, Inc. <https://www.redhat.com>`_ |