notes about EPEL and release cycles

rst/gettingstarted.rst

@@ -34,16 +34,21 @@ These distributions don't have Python 2.6 by default, but it is easily installab
 Getting Ansible
 ```````````````
 
-As the project is still pretty new, you will probably want to clone
+If you are interested in using all the latest features, you may wish to keep up to date
-the git checkout, so you can keep up with all of the latest features,
+with the development branch of the git checkout.  This also makes it easiest to contribute
-and also easily contribute back to the project (if you want).  
+back to the project.  
 
 Instructions for installing from source are below.
 
+Ansible's release cycles are about one month long.  Due to this
+short release cycle, any bugs will generally be fixed in the next release versus maintaining 
+backports on the stable branch.
+
 You may also wish to follow the `Github project <https://github.com/ansible/ansible>`_ if
 you have a github account.  This is also where we keep the issue tracker for sharing
 bugs and feature ideas.
 
+
 Running From Checkout
 +++++++++++++++++++++
 
@@ -51,6 +56,7 @@ Ansible is trivially easy to run from a checkout, root permissions are not requi
 to use it::
 
     $ git clone git://github.com/ansible/ansible.git
+    $ git checkout -t origin/devel
     $ cd ./ansible
     $ source ./hacking/env-setup
 
@@ -71,6 +77,7 @@ If you are not working from a distribution where Ansible is packaged yet, you ca
 using "make install".  This is done through `python-distutils`::
 
     $ git clone git://github.com/ansible/ansible.git
+    $ git checkout -t origin/devel
     $ cd ./ansible
     $ sudo make install
 
@@ -78,8 +85,13 @@ using "make install".  This is done through `python-distutils`::
 Via RPM
 +++++++
 
-In the near future, pre-built packages will be available through your
+RPMs for the last Ansible release are available for `EPEL <http://fedoraproject.org/wiki/EPEL>`_ 6 and currently supported
-distribution. Until that time, you can use the ``make rpm`` command to
+Fedora distributions.
+
+    # install the epel-release RPM if needed on CentOS, RHEL, or Scientific Linux
+    $ sudo yum install ansible
+
+You can also use the ``make rpm`` command to
 build an RPM you can distribute and install::
 
     $ git clone git://github.com/ansible/ansible.git
@@ -97,8 +109,9 @@ Debian, Gentoo, Arch, Others
 
 Gentoo eBuilds are available `here <https://github.com/uu/ubuilds>`_
 
-Debian package recipes are in progress -- see the source checkout, in the packaging/debian
+Debian package recipes can be built from the source checkout, run::
-directory.
+
+    make debian
 
 An Arch PKGBUILD is available on `AUR <https://aur.archlinux.org/packages.php?ID=58621>`_
 If you have python3 installed on Arch, you probably want to symlink python to python2.::
@@ -106,7 +119,7 @@ If you have python3 installed on Arch, you probably want to symlink python to py
     sudo ln -sf /usr/bin/python2 /usr/bin/python
 
 If you would like to package Ansible for Homebrew, BSD, or others,
-please stop by the mailing list and say hi.
+please stop by the mailing list and say hi!
 
 
 Tagged Releases
@@ -117,9 +130,6 @@ project page:
 
 * `Ansible/downloads <https://github.com/ansible/ansible/downloads>`_
 
-At this point in Ansible's development, running or building from checkout is preferred
-if you want access to all of the latest modules and improvements.
-
 
 Your first commands
 ```````````````````

rst/playbooks.rst

@@ -236,7 +236,7 @@ to run a playbook inside a OS installer, such as an Anaconda kickstart.
 
 To run an entire playbook locally, just set the "hosts:" line to "hosts:127.0.0.1" and then run the playbook like so::
 
-    playbook playbook.yml --connection=local
+    ansible-playbook playbook.yml --connection=local
 
 Alternatively, a local connection can be used in a single playbook play, even if other plays in the playbook
 use the default remote connection type::