Add documentation

Author: csswizardry

README.md

@@ -1,8 +1,85 @@
 # Pack
 
-inuitcss’ `pack` object simply causes any number of elements pack up
-horizontally to automatically fill an equal, fluid width of their parent.
+inuitcss’ Pack object simply causes any number of elements pack up horizontally
+to automatically fill an equal, fluid width of their parent.
 
-Install using Bower:
+## Dependencies
+
+inuitcss’ Pack object depends on two other inuitcss modules:
+
+* [settings.defaults](https://github.com/inuitcss/settings.defaults)
+* [tools.functions](https://github.com/inuitcss/tools.functions)
+
+If you install the Pack object using Bower, you will get these dependencies at
+the same time. If not using Bower, please be sure to install and `@import` these
+dependencies in the relevant way.
+
+## Installation
+
+The recommended installation method is Bower, but you can install the Pack
+module via a Git Submodule, or copy and paste.
+
+### Install using Bower:
 
     $ bower install --save inuit-pack
+
+Once installed, `@import` into your project in its Objects layer:
+
+    @import "bower_components/inuit-pack/objects.pack";
+
+### Install as a Git Submodule
+
+    $ git submodule add [email protected]:inuitcss/objects.pack.git
+
+Once installed, `@import` into your project in its Objects layer:
+
+    @import "objects.pack/objects.pack";
+
+### Install via file download
+
+The least recommended option for installation is to simply download
+`_objects.pack.scss` into your project and `@import` it into your project in
+its Objects layer.
+
+## Usage
+
+Basic usage of the Pack object uses the required classes:
+
+    <div class="pack">
+        <div class="pack__item">
+            Foo
+        </div>
+        <div class="pack__item">
+            Bar
+        </div>
+        <div class="pack__item">
+            Baz
+        </div>
+    </div>
+
+The only valid children of the `.pack` node are `.pack__item`s.
+
+## Options
+
+Other, optional classes can supplement the required base classes:
+
+* `.pack--auto`: cause packed items to have an automatically determined,
+  non-equal width.
+* `.pack--[tiny|small|large|huge]`: alter the gutter between pack items.
+* `.pack--rev`: reverse the rendered horizontal order of packed items.
+* `.pack--[middle|bottom]`: align packed items to the middles or bottoms of each
+  other.
+
+For example:
+
+    <div class="pack  pack--small  pack--rev">
+        <div class="pack__item">
+            Foo
+        </div>
+        <div class="pack__item">
+            Bar
+        </div>
+        <div class="pack__item">
+            Baz
+        </div>
+    </div>

_objects.pack.scss

@@ -16,14 +16,14 @@ $inuit-pack-gutter--small:      halve($inuit-pack-gutter) !default;
 $inuit-pack-gutter--large:     double($inuit-pack-gutter) !default;
 $inuit-pack-gutter--huge:   quadruple($inuit-pack-gutter) !default;
 
+$inuit-enable-pack--auto:   false !default;
 $inuit-enable-pack--tiny:   false !default;
 $inuit-enable-pack--small:  false !default;
 $inuit-enable-pack--large:  false !default;
 $inuit-enable-pack--huge:   false !default;
 $inuit-enable-pack--rev:    false !default;
 $inuit-enable-pack--middle: false !default;
 $inuit-enable-pack--bottom: false !default;
-$inuit-enable-pack--auto:   false !default;