update docs

Author: jhudson8

api.md

@@ -41,84 +41,35 @@ Register a set of styles which are associated with an alias which can be referen
 
 Return the [Stylesheet](#project/jhudson8/react-css-builder/package/Stylesheet) object
 
-```
-module.exports = require('react-css-builder').register('some-namespace', {
-  // the stylesets can be much more advanced, this is an example most similar to CSS
-  myClass: {
-    color: 'white'
-  },
-  anotherClass: {
-    color: 'black'
-  }
-});
-```
-see [Examples](#project/jhudson8/react-css-builder/section/Examples) to see all available options including, importing external stylesets, using mixins, variable references and nested styles.
+See [Creating a stylesheet](#project/jhudson8/react-css-builder/section/Usage/Creating%20a%20stylesheet) for more details.
+
 
 #### vars(varsObject)
 * ***varsObject***: a hash of variables to register which will be available to styleset rules (using this.get("varName")).
 
-```
-var css = require('react-css-builder');
-css.vars({
-  primaryColor: 'white'
-});
+See [variables usage](#project/jhudson8/react-css-builder/section/Usage/Variables) for more details.
+
 
-// variables available using this.get within a stylesheet rule function
-css.register('my-styleset-namespace', {
-  myClass: function() {
-    return color: this.get('primaryColor')
-  }
-});
-```
 #### mixin(mixinName, mixinFunction)
 * ***mixinName***: the name of the mixin
 * ***mixinFunction***: the mixin function which can take any number of arguments
 
 The mixin can be included in a styleset function.  It should return an object represent all style attributes which should be included.
 
-```
-var css = require('react-css-builder');
-css.mixin('background-image', function(imagePath) {
-  // silly little example
-  return {
-    backgroundImage: 'url(\"' + imagePath + '\")'
-  };
-});
-
-// mixins can be referenced using ```css.mixin``` within a stylesheet rule function (```css``` is the styleset rule function argument)
-css.register('my-styleset', {
-  myClass: function(css) {
-    return css
-      .mixin('background-image', 'foo.gif')
-      .val();
-  }
-});
-```
+See [mixin usage](#project/jhudson8/react-css-builder/section/Usage/Mixins) for details.
 
 
 ### Stylesheet
-This is the object returned when calling ```require('react-css-builder').register(...)
+This is the object returned when calling ```require('react-css-builder').register(...)```
+
 
 #### css(className)
 * ***className***: return the styleset object matching the className key which can be used for associated with a React component ```style``` property.
 
 If the ```className``` value has ```.``` values in it, styleset rules will be referenced as nested objects.
 
-```
-var stylesheet = require('react-css-builder').register({
-  panel: {
-    // attributes is a special key used when nesting if the current level should have style attributes
-    attributes: {
-      color: 'white'
-    },
-    header: {
-      color: 'black'
-    }
-  }
-});
-stylesheet.css('panel'); // = {color: 'white'}
-stylesheet.css('panel.header'); // = {color: 'black'}
-```
+See [Creating a stylesheet](#project/jhudson8/react-css-builder/section/Usage/Creating%20a%20stylesheet) for more details
+
 
 #### get(className)
 * ***className***: return the styleset object matching the className key which can be used for associated with a React component ```style``` property.
@@ -127,34 +78,30 @@ Very much like the previously described ```css``` method but allows for addition
 
 Returns a [StylesetBuilder](#project/jhudson8/react-css-builder/package/StylesetBuilder)
 
-```
-var stylesheet = require('...').register(...)
-stylesheet.get('myStyle')
-  .vars({
-    foo: 'this var will be available in the styleset function / mixin function as this.get("foo")'
-  })
-  .attr({
-    content: 'this will be an additional attribute included in the returned styleset'
-  })
-  // this returns the styleset value
-  .css();
-```
+See [styleset definitions](#project/jhudson8/react-css-builder/section/Usage/Styleset%20Definitions) for more details.
+
 
 #### mixin(mixinName, mixinFunction)
 * ***mixinName***: the name of the mixin
 * ***mixinFunction***: the mixin function which can take any number of arguments
 
 Exactly the same as [react-css-builder mixin](#project/jhudson8/react-css-builder/method/react-css-builder/mixin) except that the mixin registered will *only* be accessable to this particular stylesheet.
 
+See [mixin usage](#project/jhudson8/react-css-builder/section/Usage/Mixins) for details.
+
+
 #### vars(varsObject)
 * ***varsObject***: a hash of variables to register which will be available to styleset rules (using this.get("varName")).
 
 Exactly the same as [react-css-builder vars](l#project/jhudson8/react-css-builder/method/react-css-builder/vars) except that the provided variables will *only* be accessable to this particular stylesheet.
 
+See [variables usage](#project/jhudson8/react-css-builder/section/Usage/Variables) for more details.
+
 
 ### StylesetBuilder
 This is the object returned when calling ```get``` from a [StylesetBuilder](#project/jhudson8/react-css-builder/package/StylesetBuilder).  It is used to apply variables and attributes to a styleset request.
 
+
 #### attr(styleAttributes)
 * ***styleAttributes***: Additional attributes that should be included with the attributes defined with the styleset defined by the class name.
 
@@ -168,70 +115,35 @@ var myStyle = stylesheet.get('myStyleClass').attr({color: 'white'}).css();
 // will be {color: 'white', backgroundColor: 'black'}
 ```
 
+
 #### vars(variables)
 * ***variables***: Object specifying additional variables to be made accessable to the styleset function or referenced mixin functions as ```this.get("varName")```
 
-```
-var stylesheet = require('...').register({
-  myStyleClass: function() {
-    var radius = this.get('radius');
-    return {
-      borderRadius: radius,
-      WebkitBorderRadius: radius
-    }
-  }
-});
-var myStyle = stylesheet.get('myStyleClass').var({radius: 3}).css();
-// will be {borderRadius: 3, WebkitBorderRadius: 3}
-```
+See [variables usage](#project/jhudson8/react-css-builder/section/Usage/Variables) for more details.
+
 
 ### StyleContext
-This is the object provided as the single argument a styleset if the styleset value is a function rather than a simple object specifying the style attributes.
+This is the object provided as the single styleset if the styleset value is a function rather than a simple object specifying the style attributes.
+
+See [styleset definitions](#project/jhudson8/react-css-builder/section/Usage/Styleset%20Definitions) for more details.
+
 
 #### include(stylesetName)
 * ***stylesetName***: the name of a styleset in the current stylesheet or, if prefixed with the namespace separated by a ```.```, the name of a styleset in another stylesheet.
 
 Include all of the attributes defined by another styleset.
 
-```
-var stylesheet = require('...').register({
-  anotherStyleClass: {
-    color: 'white'
-  },
-  myStyleClass: function(css) {
-    return css
-      .include('anotherStyleClass')
-      .val();
-  }
-});
-var myStyle = stylesheet.css('myStyleClass');
-// will be {color: 'white'}
-```
+See [include usage](#project/jhudson8/react-css-builder/section/Usage/Includes) for more details.
+
 
 #### mixin(mixinName[, mixinParameters])
 * ***mixinName***: the name of a registered mixin to include
 * ***mixinParameters***: any number of parameters that the mixin is expecting
 
 Include all of the attributes returned by a registered by a mixin
 
-```
-// very silly example just to demonstrate a mixin
-var stylesheet = require('...').register({
-  myStyleClass: function(css) {
-    return css
-      .mixin('color', 'white')
-      .val();
-  }
-});
-stylesheet.register('myMixin', function(name, value) {
-  var rtn = {};
-  rtn[name] = value;
-  return rtn;
-});
+See [mixin usage](#project/jhudson8/react-css-builder/section/Usage/Mixins) for details.
 
-var myStyle = stylesheet.css('myStyleClass');
-// will be {color: 'white'}
-```
 
 #### val()
 Called when all attribute inclusions are complete to return the styleset attributes.
@@ -245,6 +157,7 @@ var stylesheet = require('...').register({
 });
 ```
 
+
 Sections
 ----------
 ### Usage