Add IRC and google groups links to each page

YAMLSyntax.html

@@ -229,6 +229,10 @@ languages:
 <dd>YAML Lint (online) helps you debug YAML syntax if you are having problems</dd>
 <dt><a class="reference external" href="https://github.com/ansible/ansible/tree/master/examples/playbooks">Github examples directory</a></dt>
 <dd>Complete playbook files from the github project source</dd>
+<dt><a class="reference external" href="http://groups.google.com/group/ansible-project">Mailing List</a></dt>
+<dd>Questions? Help? Ideas?  Stop by the list on Google Groups</dd>
+<dt><a class="reference external" href="http://irc.freenode.net">irc.freenode.net</a></dt>
+<dd>#ansible IRC chat channel</dd>
 </dl>
 </div>
 </div>

api.html

@@ -133,7 +133,11 @@ s.parentNode.insertBefore(ga, s);
 <li><a class="reference internal" href="#detailed-api-example">Detailed API Example</a></li>
 </ul>
 </li>
-<li><a class="reference internal" href="#external-inventory">External Inventory</a></li>
+<li><a class="reference internal" href="#external-inventory">External Inventory</a><ul>
+<li><a class="reference internal" href="#script-conventions">Script Conventions</a></li>
+<li><a class="reference internal" href="#example-the-cobbler-external-inventory-script">Example: The Cobbler External Inventory Script</a></li>
+</ul>
+</li>
 </ul>
 </li>
 </ul>
@@ -243,6 +247,8 @@ of these options via an external interventory system.</p>
 <p>If you have a data store system where an Ansible external inventory script doesn&#8217;t already exist, this may require a little coding,J
 but we have a <a class="reference external" href="https://github.com/ansible/ansible/blob/master/examples/scripts/cobbler_external_inventory.py">Cobbler example</a> in the main source tree &#8211; but it&#8217;s pretty simple, as we&#8217;ll explain below &#8211; that would provide a good starting point.  Like with modules, it&#8217;s possible to build an external inventory script in any language, as long as it returns JSON.</p>
 <p>If you are familiar with Puppet terminology, this concept is basically the same as &#8216;external nodes&#8217;, with the slight difference that it also defines which hosts are managed.</p>
+<div class="section" id="script-conventions">
+<h3>Script Conventions<a class="headerlink" href="#script-conventions" title="Permalink to this headline">¶</a></h3>
 <p>When the external node script is called with no arguments, the script must return a JSON hash/dictionary of all the groups to be managed, with a list of each host/IP as the value for each hash/dictionary element, like so:</p>
 <div class="highlight-python"><div class="highlight"><pre><span class="p">{</span>
     <span class="s">&#39;databases&#39;</span>  <span class="p">:</span> <span class="p">[</span> <span class="s">&#39;host1.example.com&#39;</span><span class="p">,</span> <span class="s">&#39;host2.example.com&#39;</span> <span class="p">],</span>
@@ -261,6 +267,9 @@ if the script does not wish to do this, returning an empty hash/dictionary is th
 <span class="p">}</span>
 </pre></div>
 </div>
+</div>
+<div class="section" id="example-the-cobbler-external-inventory-script">
+<h3>Example: The Cobbler External Inventory Script<a class="headerlink" href="#example-the-cobbler-external-inventory-script" title="Permalink to this headline">¶</a></h3>
 <p>It is expected that many Ansible users will also be <a class="reference external" href="http://cobbler.github.com">Cobbler</a> users.  Cobbler has a generic
 layer that allows it to represent data for multiple configuration management systems (even at the same time), and has
 been referred to as a &#8216;lightweight CMDB&#8217; by some admins.   This particular script will communicate with Cobbler
@@ -304,10 +313,15 @@ a conf.d file appropriately or something similar.  Who knows.</p>
 <dl class="last docutils">
 <dt><a class="reference internal" href="modules.html"><em>Ansible Modules</em></a></dt>
 <dd>List of built-in modules</dd>
+<dt><a class="reference external" href="http://groups.google.com/group/ansible-project">Mailing List</a></dt>
+<dd>Questions? Help? Ideas?  Stop by the list on Google Groups</dd>
+<dt><a class="reference external" href="http://irc.freenode.net">irc.freenode.net</a></dt>
+<dd>#ansible IRC chat channel</dd>
 </dl>
 </div>
 </div>
 </div>
+</div>
 
 
 </div>

examples.html

@@ -287,6 +287,10 @@ shell commands or software upgrades only.</p>
 <dd>A list of available modules</dd>
 <dt><a class="reference internal" href="playbooks.html"><em>Playbooks</em></a></dt>
 <dd>Using ansible for configuration management &amp; deployment</dd>
+<dt><a class="reference external" href="http://groups.google.com/group/ansible-project">Mailing List</a></dt>
+<dd>Questions? Help? Ideas?  Stop by the list on Google Groups</dd>
+<dt><a class="reference external" href="http://irc.freenode.net">irc.freenode.net</a></dt>
+<dd>#ansible IRC chat channel</dd>
 </dl>
 </div>
 </div>

faq.html

@@ -319,6 +319,10 @@ tasks – whether for a QA sytem, build system, or anything you can think of
 <dd>Examples of basic commands</dd>
 <dt><a class="reference internal" href="playbooks.html"><em>Playbooks</em></a></dt>
 <dd>Learning ansible&#8217;s configuration management language</dd>
+<dt><a class="reference external" href="http://groups.google.com/group/ansible-project">Mailing List</a></dt>
+<dd>Questions? Help? Ideas?  Stop by the list on Google Groups</dd>
+<dt><a class="reference external" href="http://irc.freenode.net">irc.freenode.net</a></dt>
+<dd>#ansible IRC chat channel</dd>
 </dl>
 </div>
 </div>

gettingstarted.html

@@ -253,6 +253,10 @@ you already have a working infrastructure!</p>
 <dd>Examples of basic commands</dd>
 <dt><a class="reference internal" href="playbooks.html"><em>Playbooks</em></a></dt>
 <dd>Learning ansible&#8217;s configuration management language</dd>
+<dt><a class="reference external" href="http://groups.google.com/group/ansible-project">Mailing List</a></dt>
+<dd>Questions? Help? Ideas?  Stop by the list on Google Groups</dd>
+<dt><a class="reference external" href="http://irc.freenode.net">irc.freenode.net</a></dt>
+<dd>#ansible IRC chat channel</dd>
 </dl>
 </div>
 </div>

index.html

@@ -292,7 +292,11 @@ you with questions about Ansible.</p>
 <li class="toctree-l3"><a class="reference internal" href="api.html#detailed-api-example">Detailed API Example</a></li>
 </ul>
 </li>
-<li class="toctree-l2"><a class="reference internal" href="api.html#external-inventory">External Inventory</a></li>
+<li class="toctree-l2"><a class="reference internal" href="api.html#external-inventory">External Inventory</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="api.html#script-conventions">Script Conventions</a></li>
+<li class="toctree-l3"><a class="reference internal" href="api.html#example-the-cobbler-external-inventory-script">Example: The Cobbler External Inventory Script</a></li>
+</ul>
+</li>
 </ul>
 </li>
 <li class="toctree-l1"><a class="reference internal" href="moduledev.html">Module Development Guide</a><ul>

man.html

@@ -178,6 +178,10 @@ examples of these tools in use.</p>
 <dd>List of built-in modules</dd>
 <dt><a class="reference internal" href="playbooks.html"><em>Playbooks</em></a></dt>
 <dd>Learning ansible&#8217;s configuration management language</dd>
+<dt><a class="reference external" href="http://groups.google.com/group/ansible-project">Mailing List</a></dt>
+<dd>Questions? Help? Ideas?  Stop by the list on Google Groups</dd>
+<dt><a class="reference external" href="http://irc.freenode.net">irc.freenode.net</a></dt>
+<dd>#ansible IRC chat channel</dd>
 </dl>
 </div>
 </div>

man/ansible-playbook.1.html

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>ansible-playbook</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div xml:lang="en" class="refentry" title="ansible-playbook" lang="en"><a id="id398465"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ansible-playbook — run an ansible playbook</p></div><div class="refsynopsisdiv" title="Synopsis"><a id="_synopsis"></a><h2>Synopsis</h2><p>ansible-playbook &lt;filename.yml&gt; … [options]</p></div><div class="refsect1" title="DESCRIPTION"><a id="_description"></a><h2>DESCRIPTION</h2><p><span class="strong"><strong>Ansible playbooks</strong></span> are a configuration and multinode deployment system.  Ansible-playbook is the tool
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>ansible-playbook</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div xml:lang="en" class="refentry" title="ansible-playbook" lang="en"><a id="id503630"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ansible-playbook — run an ansible playbook</p></div><div class="refsynopsisdiv" title="Synopsis"><a id="_synopsis"></a><h2>Synopsis</h2><p>ansible-playbook &lt;filename.yml&gt; … [options]</p></div><div class="refsect1" title="DESCRIPTION"><a id="_description"></a><h2>DESCRIPTION</h2><p><span class="strong"><strong>Ansible playbooks</strong></span> are a configuration and multinode deployment system.  Ansible-playbook is the tool
 used to run them.   See the project home page (link below) for more information.</p></div><div class="refsect1" title="ARGUMENTS"><a id="_arguments"></a><h2>ARGUMENTS</h2><div class="variablelist"><dl><dt><span class="term">
 <span class="strong"><strong>filename.yml</strong></span>
 </span></dt><dd>

man/ansible.1.html

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>ansible</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div xml:lang="en" class="refentry" title="ansible" lang="en"><a id="id405326"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ansible — run a command somewhere else</p></div><div class="refsynopsisdiv" title="Synopsis"><a id="_synopsis"></a><h2>Synopsis</h2><p>ansible &lt;host-pattern&gt; [-f forks] [-m module_name] [-a args]</p></div><div class="refsect1" title="DESCRIPTION"><a id="_description"></a><h2>DESCRIPTION</h2><p><span class="strong"><strong>Ansible</strong></span> is an extra-simple tool/framework/API for doing 'remote things' over
+<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>ansible</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /></head><body><div xml:lang="en" class="refentry" title="ansible" lang="en"><a id="id302414"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ansible — run a command somewhere else</p></div><div class="refsynopsisdiv" title="Synopsis"><a id="_synopsis"></a><h2>Synopsis</h2><p>ansible &lt;host-pattern&gt; [-f forks] [-m module_name] [-a args]</p></div><div class="refsect1" title="DESCRIPTION"><a id="_description"></a><h2>DESCRIPTION</h2><p><span class="strong"><strong>Ansible</strong></span> is an extra-simple tool/framework/API for doing 'remote things' over
 SSH.</p></div><div class="refsect1" title="ARGUMENTS"><a id="_arguments"></a><h2>ARGUMENTS</h2><div class="variablelist"><dl><dt><span class="term">
 <span class="strong"><strong>host-pattern</strong></span>
 </span></dt><dd>

moduledev.html

@@ -378,6 +378,10 @@ Stop by the mailing list to inquire about requirements.</p>
 <dd>Learn about available modules</dd>
 <dt><a class="reference external" href="https://github.com/ansible/ansible/tree/master/library">Github modules directory</a></dt>
 <dd>Browse source of core modules</dd>
+<dt><a class="reference external" href="http://groups.google.com/group/ansible-project">Mailing List</a></dt>
+<dd>Questions? Help? Ideas?  Stop by the list on Google Groups</dd>
+<dt><a class="reference external" href="http://irc.freenode.net">irc.freenode.net</a></dt>
+<dd>#ansible IRC chat channel</dd>
 </dl>
 </div>
 </div>

modules.html

@@ -408,6 +408,10 @@ arguments just like they would be passed with ansible.</p>
 <dd>Examples of using modules with /usr/bin/ansible-playbook</dd>
 <dt><a class="reference internal" href="api.html"><em>API &amp; Integrations</em></a></dt>
 <dd>Examples of using modules with the Python API</dd>
+<dt><a class="reference external" href="http://groups.google.com/group/ansible-project">Mailing List</a></dt>
+<dd>Questions? Help? Ideas?  Stop by the list on Google Groups</dd>
+<dt><a class="reference external" href="http://irc.freenode.net">irc.freenode.net</a></dt>
+<dd>#ansible IRC chat channel</dd>
 </dl>
 </div>
 </div>

patterns.html

@@ -216,6 +216,10 @@ wildcards:</p>
 <dd>Examples of basic commands</dd>
 <dt><a class="reference internal" href="playbooks.html"><em>Playbooks</em></a></dt>
 <dd>Learning ansible&#8217;s configuration management language</dd>
+<dt><a class="reference external" href="http://groups.google.com/group/ansible-project">Mailing List</a></dt>
+<dd>Questions? Help? Ideas?  Stop by the list on Google Groups</dd>
+<dt><a class="reference external" href="http://irc.freenode.net">irc.freenode.net</a></dt>
+<dd>#ansible IRC chat channel</dd>
 </dl>
 </div>
 </div>

rst/YAMLSyntax.rst

@@ -88,5 +88,8 @@ That's all you really need to know about YAML to get started writing
        YAML Lint (online) helps you debug YAML syntax if you are having problems
    `Github examples directory <https://github.com/ansible/ansible/tree/master/examples/playbooks>`_
        Complete playbook files from the github project source
-
+   `Mailing List <http://groups.google.com/group/ansible-project>`_
+       Questions? Help? Ideas?  Stop by the list on Google Groups
+   `irc.freenode.net <http://irc.freenode.net>`_
+       #ansible IRC chat channel
 

rst/api.rst

@@ -96,7 +96,7 @@ If you are familiar with Puppet terminology, this concept is basically the same
 
 
 Script Conventions
-++++++++++++++++++
+``````````````````
 
 When the external node script is called with no arguments, the script must return a JSON hash/dictionary of all the groups to be managed, with a list of each host/IP as the value for each hash/dictionary element, like so::
 
@@ -117,7 +117,7 @@ if the script does not wish to do this, returning an empty hash/dictionary is th
     }
 
 Example: The Cobbler External Inventory Script
-++++++++++++++++++++++++++++++++++++++++++++++
+``````````````````````````````````````````````
 
 It is expected that many Ansible users will also be `Cobbler <http://cobbler.github.com>`_ users.  Cobbler has a generic
 layer that allows it to represent data for multiple configuration management systems (even at the same time), and has
@@ -174,4 +174,8 @@ So that's the Cobbler integration support -- using the cobbler script as an exam
 
    :doc:`modules`
        List of built-in modules
+   `Mailing List <http://groups.google.com/group/ansible-project>`_
+       Questions? Help? Ideas?  Stop by the list on Google Groups
+   `irc.freenode.net <http://irc.freenode.net>`_
+       #ansible IRC chat channel
 

rst/examples.rst

@@ -156,5 +156,11 @@ shell commands or software upgrades only.
        A list of available modules
    :doc:`playbooks`
        Using ansible for configuration management & deployment
+   `Mailing List <http://groups.google.com/group/ansible-project>`_ 
+       Questions? Help? Ideas?  Stop by the list on Google Groups
+   `irc.freenode.net <http://irc.freenode.net>`_
+       #ansible IRC chat channel
+
+
 
 

rst/faq.rst

@@ -187,4 +187,8 @@ tasks -- whether for a QA sytem, build system, or anything you can think of.
        Examples of basic commands
    :doc:`playbooks`
        Learning ansible's configuration management language
+   `Mailing List <http://groups.google.com/group/ansible-project>`_
+       Questions? Help? Ideas?  Stop by the list on Google Groups
+   `irc.freenode.net <http://irc.freenode.net>`_
+       #ansible IRC chat channel
 

rst/gettingstarted.rst

@@ -104,4 +104,8 @@ you already have a working infrastructure!
        Examples of basic commands
    :doc:`playbooks`
        Learning ansible's configuration management language
+   `Mailing List <http://groups.google.com/group/ansible-project>`_
+       Questions? Help? Ideas?  Stop by the list on Google Groups
+   `irc.freenode.net <http://irc.freenode.net>`_
+       #ansible IRC chat channel
 

rst/man.rst

@@ -24,4 +24,8 @@ ansible-playbook(1)
        List of built-in modules
    :doc:`playbooks`
        Learning ansible's configuration management language
+   `Mailing List <http://groups.google.com/group/ansible-project>`_
+       Questions? Help? Ideas?  Stop by the list on Google Groups
+   `irc.freenode.net <http://irc.freenode.net>`_
+       #ansible IRC chat channel
 

rst/moduledev.rst

@@ -248,4 +248,8 @@ Stop by the mailing list to inquire about requirements.
        Learn about available modules
    `Github modules directory <https://github.com/ansible/ansible/tree/master/library>`_
        Browse source of core modules
+   `Mailing List <http://groups.google.com/group/ansible-project>`_
+       Questions? Help? Ideas?  Stop by the list on Google Groups
+   `irc.freenode.net <http://irc.freenode.net>`_
+       #ansible IRC chat channel
 

rst/modules.rst

@@ -301,3 +301,8 @@ arguments just like they would be passed with ansible.
        Examples of using modules with /usr/bin/ansible-playbook
    :doc:`api`
        Examples of using modules with the Python API
+   `Mailing List <http://groups.google.com/group/ansible-project>`_
+       Questions? Help? Ideas?  Stop by the list on Google Groups
+   `irc.freenode.net <http://irc.freenode.net>`_
+       #ansible IRC chat channel
+

rst/patterns.rst

@@ -71,4 +71,8 @@ Easy enough.  Now see :doc:`examples` and then :doc:`playbooks` for how to do th
        Examples of basic commands
    :doc:`playbooks`
        Learning ansible's configuration management language
+   `Mailing List <http://groups.google.com/group/ansible-project>`_
+       Questions? Help? Ideas?  Stop by the list on Google Groups
+   `irc.freenode.net <http://irc.freenode.net>`_
+       #ansible IRC chat channel