Give extra info in table documentation

Author: michaelrevans

docs/components/table.md

@@ -2,12 +2,12 @@
 
 Show [specs](../../spec/usage/components/table_spec.rb)
 
-Use tables to implement `<table>`, `<tr>`, `<th>` and `<td>`-tags.
+Use tables to implement `<table>`, `<tr>`, `<th>`, `<td>`, `<thead>`, `<tbody>` and `<tfoot>` tags.
 
 ## Parameters
 
-`<table>`, `<tr>`, can take 2 optional configuration params.
-`<th>` and `<td>`-tags can also take a third param, text input.
+`<table>`, `<tr>`, `<thead>`, `<tbody>` and `<tfoot>` can take 2 optional configuration params.
+`<th>` and `<td>` tags can also take a third param, text input.
 
 #### # id (optional)
 Expects a string with all ids the element should have.
@@ -139,3 +139,72 @@ returns
   </tr>
 </table>
 ```
+
+## Example 3
+
+`thead`, `tbody` and `tfoot` are optional containers for any number of `tr`s. If none are specified, `tbody` will be used to contain all `tr` components. `thead` is typically used for the head of the table, and `tfoot` for any table footer, where applicable, such as a sum or count.
+
+```ruby
+table do
+  thead do
+    tr do
+      th text: "Product"
+      th text: "Price"
+    end
+  end
+  # tbody is unnecessary, since it has no class or id and will be added automatically
+  # tbody do
+    tr do
+      td text: "Apples"
+      td text: "3.50"
+    end
+    tr do
+      td text: "Oranges"
+      td text: "2.75"
+    end
+    tr do
+      td text: "Bananas"
+      td text: "4.99"
+    end
+  # end
+  tfoot do
+    tr do
+      td text: "Total:"
+      td text: "11.24"
+    end
+  end
+end
+```
+
+returns
+
+```html
+<table>
+  <thead>
+    <tr>
+      <th>Product</th>
+      <th>Price</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Apples</td>
+      <td>3.50</td>
+    </tr>
+    <tr>
+      <td>Oranges</td>
+      <td>2.75</td>
+    </tr>
+    <tr>
+      <td>Bananas</td>
+      <td>4.99</td>
+    </tr>
+  </tbody>
+  <tfoot>
+    <tr>
+      <td>Total:</td>
+      <td>11.24</td>
+    </tr>
+  </tfoot>
+</table>
+```