Add source admonition

Using puppet modules from source is no longer required. However, it's
still useful to document how to do so for those that want to. This
creates a new source admonition that can be used to document such
things.

Change-Id: I5393bbfca51ebe97065995123a3d59a8719aaa81

doc/source/_custom/custom.css

@@ -65,6 +65,7 @@
 .baremetal {background: #eef;}
 .virtual {background: #efe;}
 .ceph {background: #eff;}
+.source {background: #bbb;}
 
 /* admonition selector */
 #admonition_selector {

doc/source/_templates/layout.html

@@ -36,6 +36,14 @@
       <ul>
         <li><input type="checkbox" id="ceph" checked="checked"><label for="ceph" title="Step that should only be run when deploying Ceph for use by the Overcloud.">Ceph</label></li>
       </ul>
+
+      <span class="title">Development options</span>
+      <ul>
+        <li><input type="checkbox" id="source" checked=""><label for="source"
+            title="Step that should only be run when choosing to use some components directly from their git source code repositories instead of packages.">Installing from source/git</label></li>
+      </ul>
+
+
     </div>
   </div>
 

doc/source/basic_deployment/basic_deployment_cli.rst

@@ -134,10 +134,13 @@ non-root user that was used to install the undercloud.
 
       export DELOREAN_TRUNK_MGT_REPO="http://trunk.rdoproject.org/centos7/current/"
 
-  For the moment, git checkouts of the puppet modules must be used. Export the
-  following environment variable::
+  .. admonition:: Source
+     :class: source
 
-    export DIB_INSTALLTYPE_puppet_modules=source
+     Git checkouts of the puppet modules can be used instead of packages. Export the
+     following environment variable::
+
+       export DIB_INSTALLTYPE_puppet_modules=source
 
   ::
 

doc/source/index.rst

@@ -61,5 +61,11 @@ steps are marked as follows:
 
    Step that should only be run when deploying Ceph for use by the Overcloud
 
+.. admonition:: Source
+   :class: source
+
+   Step that should only be run when choosing to use some components directly
+   from their git source code repositories instead of packages.
+
 Any such steps should *not* be run if the target environment does not match
 the section marking.

doc/source/installation/installing.rst

@@ -71,10 +71,13 @@ Installing the Undercloud
 
         cp /usr/share/instack-undercloud/undercloud.conf.sample ~/undercloud.conf
 
-  For the moment, git checkouts of the puppet modules must be used. Export the
-  following environment variable::
+  .. admonition:: Source
+     :class: source
 
-    export DIB_INSTALLTYPE_puppet_modules=source
+     Git checkouts of the puppet modules can be used instead of packages. Export the
+     following environment variable::
+
+       export DIB_INSTALLTYPE_puppet_modules=source
 
   Install the undercloud::