Update README.md

README.md

 Ansible Resources
 =================
 
-User contributed playbooks, modules, and articles
+User contributed playbooks, modules, and articles.  This is a small curated list, but growing.  Everyone is encouraged to add to this document, 
+submit a pull request at http://github.com/ansible/ansible-resources.
 
 Ansible Modules
 ===============
 
+Ansible modules are a way of adding new client-side logic to ansible.  They can be written in any language.
+
 * [Official "core" ansible modules](http://ansible.github.com/modules.html) - various
 * [mercurial](https://github.com/bradobro/ansible-module-mercurial) - bradobro
 * [zypper (bash module example)](https://github.com/jpmens/ansible-zypp) - jp_mens
@@ -13,14 +16,19 @@ Ansible Modules
 * [homebrew](https://gist.github.com/3170079) - swehack
 
 Python modules using 0.6 and later can use the common "AnsibleModule" class to dramatically reduce
-the amount of boilerplate code required.  Modules can be written in any language, however.
+the amount of boilerplate code required.  Not all modules above yet take advantage of this feature.
+See the official documentation for more details.
 
 Selected Playbooks
 ==================
 
+[Playbooks](http://ansible.github.com/playbooks.html) are ansible's configuration management language.  It should
+be easy to write your own from scratch for most applications, but it's always helpful to look at what others have
+done for reference.
+
 * [Hadoop](https://github.com/jkleint/ansible-contrib/tree/master/playbooks/hadoop_jkleint) - jkleint
 * [LAMP](https://github.com/fourkitchens/server-playbooks) - [Four Kitchens](http://fourkitchens.com)
-* [Ganglia](https://github.com/mpdehaan/ansible-examples) - mpdehaan
+* [Ganglia (demo)](https://github.com/mpdehaan/ansible-examples) - mpdehaan
 * [Nginx](http://www.capsunlock.net/2012/04/ansible-nginx-playbook.html) - imcocoy
 
 Blogs & Articles
@@ -34,16 +42,12 @@ Blogs & Articles
 * [Ansible Facts](http://jpmens.net/2012/07/15/ansible-it-s-a-fact/) - jp_mens
 * [Ansible Pull Mode](http://www.capsunlock.net/2012/05/using-ansible-pull-and-user-data-to-setup-ec2-or-openstack-servers.html) - imcocoy
 
-Updates
-========
-
-To make additions to this doucment, submit a pull request at http://github.com/ansible/ansible-resources
-
 Disclaimer
 ==========
 
 Modules and playbooks here may not be using the latest in Ansible features.   When in doubt to the features of
-a particular version of Ansbile, always consult [ansible.github.com](http://ansible.github.com)
+a particular version of Ansbile, always consult [ansible.github.com](http://ansible.github.com) and in particular
+see [Best Practices](http://ansible.github.com/bestpractices.html) for some tips and tricks that may be useful.
 
 Ansible is (C) 2012, [Michael DeHaan](http://twitter.com/laserllama) and others and is available under the GPLv3 license.  Content here is as specified
 by individual contributors.