summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorSandra McCann <samccann@redhat.com>2020-02-17 16:12:45 -0500
committerGitHub <noreply@github.com>2020-02-17 15:12:45 -0600
commit79ad190f71b75db47b748b07b28e878f4a14976f (patch)
tree608fed33ce75362fa51f2a662ee9175cd96f153d /docs
parent9895e18e24237587bc588012bd0d6915a9f4685e (diff)
downloadansible-79ad190f71b75db47b748b07b28e878f4a14976f.tar.gz
[backport][2.9]Add note that devel branch should not be used in real environments (#… (#67494)
* Add note that devel branch should not be used in real environments (#67483) (cherry picked from commit 39fef58beaca3510ec4465f74071c736578ccbf1)
Diffstat (limited to 'docs')
-rw-r--r--docs/docsite/rst/installation_guide/intro_installation.rst17
1 files changed, 9 insertions, 8 deletions
diff --git a/docs/docsite/rst/installation_guide/intro_installation.rst b/docs/docsite/rst/installation_guide/intro_installation.rst
index 2f75842933..4e3beb0ed9 100644
--- a/docs/docsite/rst/installation_guide/intro_installation.rst
+++ b/docs/docsite/rst/installation_guide/intro_installation.rst
@@ -84,11 +84,12 @@ Which Ansible version to install is based on your particular needs. You can choo
* Install the latest release with your OS package manager (for Red Hat Enterprise Linux (TM), CentOS, Fedora, Debian, or Ubuntu).
* Install with ``pip`` (the Python package manager).
-* Install from source to access the development (``devel``) version to use and test the latest features.
+* Install from source to access the development (``devel``) version to develop or test the latest features.
+.. note::
+
+ You should only run Ansible from ``devel`` if you are actively developing content for Ansible. This is a rapidly changing source of code and can become unstable at any point.
-Because Ansible runs so easily from source and does not require any installation of software on remote
-machines, many users will actually track the development version.
Ansible creates new releases two to three times a year. Due to this short release cycle,
minor bugs will generally be fixed in the next release versus maintaining backports on the stable branch.
@@ -348,13 +349,13 @@ If you wish to install Ansible globally, run the following commands::
Running Ansible from source (devel)
-----------------------------------
+.. note::
+
+ You should only run Ansible from ``devel`` if you are actively developing content for Ansible. This is a rapidly changing source of code and can become unstable at any point.
+
Ansible is easy to run from source. You do not need ``root`` permissions
to use it and there is no software to actually install. No daemons
-or database setup are required. Because of this, many users in our community use the
-development version of Ansible all of the time so they can take advantage of new features
-when they are implemented and easily contribute to the project. Because there is
-nothing to install, following the development version is significantly easier than most
-open source projects.
+or database setup are required.
.. note::