add tagging source options

Matt Singleton · Matt Singleton · commit e2d31c6155e9 · 2013-02-13T13:51:48.000-05:00
diff --git a/content/api.html b/content/api.html
@@ -469,6 +469,11 @@ <h3 id="tags">Tags</h3>
           to hosts by name (<code>yourhost.example.com</code>) or id
           (<code>12345</code>).
         </p>
+        <p>
+        The component of your infrastructure responsible for a tag is identified by
+        a <code>source</code>. Valid sources are: nagios, hudson, jenkins, users,
+        feed, chef, puppet, git, bitbucket, fabric, capistrano.
+        </p>
       </div>
     </div>
 
@@ -479,7 +484,9 @@ <h4 id="tags-get">Get Tags</h4>
           Return a mapping of tags to hosts for your whole infrastructure.
         </p>
         <h5>Arguments</h5>
-        <%= no_args %>
+        <ul class="arguments">
+          <%= argument("source", "Only show tags from a particular source. Otherwise shows all tags.", :default => "None") %>
+        </ul>
       </div>
       <%= right_side_div %>
         <h5>Signature</h5>
@@ -502,7 +509,10 @@ <h4 id="tags-get-host">Get Host Tags</h4>
           Return the list of tags that apply to a given host.
         </p>
         <h5>Arguments</h5>
-        <%= no_args %>
+        <ul class="arguments">
+          <%= argument("source", "Only show tags from a particular source. Otherwise shows all tags.", :default => "None") %>
+          <%= argument("by_source", "Return tags grouped by source.", :default => "False") %>
+        </ul>
       </div>
       <%= right_side_div %>
         <h5>Signature</h5>
@@ -527,6 +537,7 @@ <h4 id="tags-add">Add Tags to a Host</h4>
          <h5>Arguments</h5>
           <ul class="arguments">
           <%= argument("tags", "A list of tags to apply to the host") %>
+          <%= argument("source", "The source of the tags (e.g. chef, puppet).", :default => "users") %>
           </ul>
       </div>
       <%= right_side_div %>
@@ -552,6 +563,7 @@ <h4 id="tags-update">Update Host Tags</h4>
          <h5>Arguments</h5>
           <ul class="arguments">
           <%= argument("tags", "A list of tags") %>
+          <%= argument("source", "The source of the tags (e.g. chef, puppet).", :default => "users") %>
           </ul>
       </div>
       <%= right_side_div %>
@@ -575,7 +587,9 @@ <h4 id="tags-remove">Remove Host Tags</h4>
           This end point allows you to update all tags for a given host.
         </p>
          <h5>Arguments</h5>
-          <%= no_args %>
+          <ul class="arguments">
+          <%= argument("source", "The source of the tags (e.g. chef, puppet).", :default => "users") %>
+          </ul>
       </div>
       <%= right_side_div %>
         <h5>Signature</h5>
