Merge branch 'master' of github.com:Semantic-Org/Semantic-UI-Docs into next

Author: jlukic

server/documents/behaviors/api.html.eco

@@ -28,7 +28,7 @@ type        : 'UI Behavior'
       <h4 class="ui header">Specifying Validation Rules</h4>
       <p>Form validation requires passing in a validation object with the rules required to validate your form.</p>
       <div class="ui ignored info message">
-        A validation object includes a list of form elements, and rules to validate each field against. Fields are matched by either the <code>id</code>, <code>name</code>, or <code>data-validate</code>  property matching the identifier specified in the settings object. Validation objects must use either shorthand or longhand exclusively.
+        A validation object includes a list of form elements, and rules to validate each field against. Fields are matched by either the <code>id</code>, <code>name</code>, or <code>data-validate</code> property (in that order) matching the identifier specified in the settings object. Validation objects must use either shorthand or longhand exclusively.
       </div>
       <div class="ignore code" data-title="Shorthand Validation">
       $('.ui.form')
@@ -312,10 +312,10 @@ type        : 'UI Behavior'
       <div class="ignored code">
       $('.ui.form')
         .form({
-          fields: [
+          fields: {
            email: 'empty',
            name: 'empty'
-          ]
+          }
         })
       ;
       if( $('.ui.form').form('is valid', 'email')) {
@@ -427,7 +427,7 @@ type        : 'UI Behavior'
           </tr>
           <tr>
             <td>doesntContainExactly</td>
-            <td>A field doesn't text (case sensitive)</td>
+            <td>A field doesn't contain text (case sensitive)</td>
             <td><code>doesntContainExactly[foo]</code></td>
           </tr>
           <tr>
@@ -1588,7 +1588,7 @@ type        : 'UI Behavior'
       <p>Adding the parameter <code>optional: true</code> will only add your validation rules when the field is <b>not empty</b>.
       <div class="ignored code">
       $('.ui.form')
-        .form(
+        .form({
           fields: {
             email: {
               identifier : 'email',
@@ -1875,6 +1875,10 @@ type        : 'UI Behavior'
         <td>add errors(errors)</td>
         <td>Adds errors to form, given an array errors</td>
       </tr>
+      <tr>
+        <td>add prompt(id, prompt)</td>
+        <td>Adds a custom user prompt for a given element with id</td>
+      </tr>
     </table>
 
     <h2 class="ui dividing header">Settings</h2>
@@ -2141,7 +2145,7 @@ type        : 'UI Behavior'
           </tr>
           <tr>
             <td>debug</td>
-            <td>True</td>
+            <td>False</td>
             <td>Provides standard debug output to console</td>
           </tr>
           <tr>
@@ -2151,7 +2155,7 @@ type        : 'UI Behavior'
           </tr>
           <tr>
             <td>verbose</td>
-            <td>True</td>
+            <td>False</td>
             <td>Provides ancillary debug output to console</td>
           </tr>
           <tr>

server/documents/behaviors/form.html.eco

@@ -1213,7 +1213,7 @@ themes      : ['Default', 'Flat', 'Chubby', 'GitHub']
   </div>
 
   <div class="example" data-use-content="true">
-    <h4 class="ui header">Equal Width</h4>
+    <h4 class="ui header">Equal Width Form</h4>
     <p>Forms can automatically divide fields to be equal width</p>
     <div class="ui equal width form">
       <div class="fields">
@@ -1274,7 +1274,7 @@ themes      : ['Default', 'Flat', 'Chubby', 'GitHub']
   <h2 class="ui dividing header">Field Variations</h2>
 
   <div data-use-content="true" class="example">
-    <h4 class="ui header">Inline</h4>
+    <h4 class="ui header">Inline Field</h4>
     <p>A field can have its label next to instead of above it.</p>
     <div class="ui form">
       <div class="inline field">
@@ -1401,7 +1401,7 @@ themes      : ['Default', 'Flat', 'Chubby', 'GitHub']
   </div>
 
   <div class="example" data-use-content="true">
-    <h4 class="ui header">Equal Width</h4>
+    <h4 class="ui header">Equal Width Fields</h4>
     <p>Fields can automatically divide fields to be equal width</p>
     <div class="ui form">
       <div class="fields">
@@ -1433,7 +1433,7 @@ themes      : ['Default', 'Flat', 'Chubby', 'GitHub']
 
 
   <div class="example" data-use-content="true">
-    <h4 class="ui header">Inline</h4>
+    <h4 class="ui header">Inline Fields</h4>
     <p>Multiple fields may be inline in a row</p>
     <div class="ui form">
       <div class="inline fields">

server/documents/collections/form.html.eco

@@ -43,7 +43,7 @@ themes      : ['Default']
     <div class="highlighted example" data-use-content="true" data-class="column">
       <h4 class="ui header">Columns</h4>
       <p>Grids divide horizontal space into indivisible units called "columns". All columns in a grid must specify their width as proportion of the total available row width.</p>
-      <p>All grid systems chooses an arbitrary column count to allow per row. Semantic's default theme uses <b>16 columns</b>.</p>
+      <p>All grid systems choose an arbitrary column count to allow per row. Semantic's default theme uses <b>16 columns</b>.</p>
 
       <p>The example below shows four <code>four wide</code> columns will fit in the first row, <code>16 / 4 = 4</code>, and three various sized columns in the second row. <code>2 + 8 + 6 = 16</code></p>
 

server/documents/collections/grid.html.eco

@@ -325,7 +325,7 @@ themes      : ['Default', 'Basic', 'Classic', 'GitHub']
 
     <div class="ui ignored info message">
       <p>UI tables use <code>border-collapse: separate</code> to allow for tables to receive styles that cannot usually be applied to tables like <code>border-radius</code>. However this can cause some cell borders to appear missing with complex layouts that use <code>rowspan</code> or <code>colspan</code> and rows with varying column count.</p>
-      <p><code>ui complex table</code> does not support some style features, but can correctly display all valid HTML table content.</p>
+      <p><code>ui structured table</code> does not support some style features, but can correctly display all valid HTML table content.</p>
     </div>
 
     <table class="ui celled structured table">
@@ -862,34 +862,6 @@ themes      : ['Default', 'Basic', 'Classic', 'GitHub']
       </tbody>
     </table>
   </div>
-  <div class="another example">
-    <table class="ui selectable inverted table">
-      <thead>
-        <tr>
-          <th>Name</th>
-          <th>Status</th>
-          <th class="right aligned">Notes</th>
-        </tr>
-      </thead>
-      <tbody>
-        <tr>
-          <td>John</td>
-          <td>Approved</td>
-          <td class="right aligned">None</td>
-        </tr>
-        <tr>
-          <td>Jamie</td>
-          <td>Approved</td>
-          <td class="right aligned">Requires call</td>
-        </tr>
-        <tr>
-          <td>Jill</td>
-          <td>Denied</td>
-          <td class="right aligned">None</td>
-        </tr>
-      </tbody>
-    </table>
-  </div>
 
   <div class="example">
     <h4 class="ui header">Vertical Alignment</h4>

server/documents/collections/table.html.eco

@@ -38,7 +38,7 @@ themes      : ['default']
       A vertical divider will automatically swap to a horizontal divider at mobile resolutions when used inside a <a href="/collections/grid.html#stackable-grid"><code>stackable grid</code></a>
     </div>
     <div class="ui warning ignored message">
-      There is a know bug of vertical dividers after a W3C update. Please read <a href="https://github.com/Semantic-Org/Semantic-UI/issues/4342" target="_blank" rel="nofollow">#4342</a> for more information
+      There is a known bug of vertical dividers after a W3C update. Please read <a href="https://github.com/Semantic-Org/Semantic-UI/issues/4342" target="_blank" rel="nofollow">#4342</a> for more information
     </div>
     <div class="ui three column very relaxed grid">
       <div class="column">

server/documents/elements/divider.html.eco

@@ -6,7 +6,7 @@ elementType : 'element'
 standalone  : true
 
 title       : 'Flag'
-description : 'A flag is is used to represent a political state'
+description : 'A flag is used to represent a political state'
 type        : 'UI Element'
 
 ---

server/documents/elements/flag.html.eco

@@ -305,7 +305,8 @@ themes      : ['Default', 'GitHub']
 
   <div class="example" data-class="floating">
     <h4 class="ui header">Floating</h4>
-    <p>A label can float above another element</p>
+    <p>A label can float above another element.</p>
+    <div class="ui ignored warning message">A floating label must be positioned inside a container with <b>position: relative</b> to display properly.</div>
     <div class="ui compact menu">
       <a class="item">
         <i class="icon mail"></i> Messages

server/documents/elements/label.html.eco

@@ -68,7 +68,7 @@ themes      : ['Default', 'Duo', 'Pulsar']
     <h4 class="ui header">Active</h4>
     <p>A loader can be active or visible</p>
     <div class="ui ignored info message">
-      An active dimmer may not be clearly visible without using a <a href="/modules/dimmer.html">ui dimmer</a>
+      An active loader may not be clearly visible without using a <a href="/modules/dimmer.html">ui dimmer</a>
     </div>
     <div class="ui segment">
       <div class="ui active loader"></div>

server/documents/elements/loader.html.eco

@@ -5,7 +5,7 @@ element     : 'reset'
 elementType : 'global'
 
 title       : 'Reset'
-description : 'A reset is a set of normalized values for CSS properties that correct for aberations in browser defaults'
+description : 'A reset is a set of normalized values for CSS properties that correct for abberations in browser defaults'
 type        : 'UI Global'
 
 themes      : ['Default', 'Basic', 'Resetcss']
@@ -19,6 +19,9 @@ themes      : ['Default', 'Basic', 'Resetcss']
   <div class="ui active tab" data-tab="overview">
     <h2 class="ui dividing header">What's In Our Reset</h2>
     <p>Semantic's default theme includes the latest <a href="http://necolas.github.io/normalize.css/">Normalize CSS</a> to provide a base line HTML reset. In addition, Semantic UI requires a <b>Box-sizing</b> reset, to make sure that elements handle width definitions in the same way.</p>
+    <div class="ui text message info ignore">
+      The reset is required for Semantic UI components to function properly, and should also be included when using individual components.
+    </div>
 
     <h2 class="ui dividing header">Reset Options</h2>
     <p>