Update docs

Author: leoj3n

bit-docs.js

@@ -1,12 +1,18 @@
 /**
- * @module {function} bit-docs-prettify
  * @parent plugins
+ * @module {function} bit-docs-prettify
+ * @group bit-docs-prettify/static static
  *
  * @description A bit-docs plugin that makes source-code snippets in HTML prettier.
- *
+ * 
  * @body
- *
- * TBD
+ * 
+ * This plugin registers onto the `html` hook.
+ * 
+ * Registering the `html` hook adds a static JavaScript file
+ * [bit-docs-prettify/prettify.js] that will go through every `<code>` element
+ * on the page applying the
+ * [code prettifier](https://github.com/google/code-prettify).
  */
 module.exports = function(bitDocs){
     var pkg = require("./package.json");

prettify.js

@@ -1,6 +1,19 @@
 require("./prettify-engine");
 require("./prettify.less")
 
+/**
+ * @parent bit-docs-prettify/static
+ * @module {function} bit-docs-prettify/prettify.js
+ * 
+ * Main front end JavaScript file for static portion of this plugin.
+ * 
+ * @signature `prettyPrint()`
+ * 
+ * Finds all `<code>` elements on the page and adds the `prettyprint` class
+ * before executing the required pretty print engine.
+ * 
+ * Also requires [bit-docs-prettify/prettify.less].
+ */
 module.exports = function(){
     var codes = document.getElementsByTagName("code");
     for(var i = 0; i < codes.length; i ++){

prettify.less

@@ -1,55 +1,65 @@
 @import "locate://bit-docs-site/styles/variables.less";
 
 /**
-* @stylesheet code.less Code Rendering
-* @parent Styles.baseline-elements
-*
-* @description
-* Enables both the layout of code wells, and also the syntax highlighting of the specific code language. Syntax coloring provided by prettify.js with the <a href="https://github.com/chriskempson/tomorrow-theme">Tomorrow Theme</a>.
-*
-* Code "wells" are styled based on the use of the `<pre>` and `<code>` tags around your desired code example.
-*
-* Below are a few examples in various languages. This is not an exhaustive list of supported languages.
-*
-* ### HTML
-* ```
-* <pre>
-    <code>
-      <div class="example"><!--with a comment -->
-        <h1>Example</h1>
-        <p>This is some example code that is being styled.</p>
-      </div>
-    </code>
-  </pre>
-*
-* ```
-* ### JavaScript
-*```
-var foo = require('f'),
-    bar = require('br'),
-    writeFile = f.denodify(br.writeFile),
-    path = require('path');
-
-module.exports = function(littlePromise, options){
-   return littlePromise.then(function(little){
-     return writeFile(
-         path.join(options.dest,'little.json'),
-         JSON.stringify(little) );
-   });
-};
-* ```
-* ### JSON
-*```
-{
-  "sites": {
-    "docs": {
-      "key" : "value"
-    }
-  }
-}
-* ```
-*
-**/
+ * @parent bit-docs-prettify/static
+ * @module bit-docs-prettify/prettify.less
+ *
+ * @description Layout of code wells and syntax highlighting of code languages.
+ *
+ * @body
+ *
+ * Syntax highlighting and colors provided by 
+ * [JavaScript code prettifier](https://github.com/google/code-prettify) and
+ * [Tomorrow Theme](https://github.com/chriskempson/tomorrow-theme).
+ *
+ * Code "wells" are styled based on the use of the `<pre>` and `<code>` tags
+ * around your desired code example.
+ *
+ * Below are examples in a few of the supported languages.
+ *
+ * ### HTML
+ *
+ * ```html
+ * <pre>
+ *   <code>
+ *     <div class="example"><!--with a comment -->
+ *       <h1>example</h1>
+ *       <p>this is some example code that is being styled.</p>
+ *     </div>
+ *   </code>
+ * </pre>
+ *
+ * ```
+ *
+ * ### JavaScript
+ *
+ *```js
+ * var foo = require('f'),
+ *     bar = require('br'),
+ *     writefile = f.denodify(br.writefile),
+ *     path = require('path');
+ * 
+ * module.exports = function(littlepromise, options){
+ *    return littlepromise.then(function(little){
+ *      return writefile(
+ *          path.join(options.dest,'little.json'),
+ *          json.stringify(little) );
+ *    });
+ * };
+ * ```
+ *
+ * ### JSON
+ *
+ *```json
+ * {
+ *   "sites": {
+ *     "docs": {
+ *       "key" : "value"
+ *     }
+ *   }
+ * }
+ * ```
+ */
 code {
 	background-color: @colorCode;
   border-radius: 5px;