Fill out docus for bit-docs.js

Author: leoj3n

bit-docs.js

@@ -14,13 +14,31 @@ var mergeOnto = function(prop, dest, source){
  * @group bit-docs-generate-html/modules modules
  * @group bit-docs-generate-html/static static
  * @group bit-docs-generate-html/templates templates
+ * @group bit-docs-generate-html/generated generated
  * @group bit-docs-generate-html/types types
  *
- * @description Generates HTML for a docMap.  Supports plugins.
+ * @description Generates HTML for a docMap and handles the `html` hook.
  *
  * @body
  *
- * TBD
+ * This plugin registers onto these hooks:
+ *   - `tags`
+ *   - `generator`
+ * 
+ * Registering the `tags` hook adds the `@templaterender` tag.
+ * 
+ * Registering the `generator` hook makes it so this plugin can generate the
+ * HTML output from the provided [bit-docs/types/docMap]. The entry point for
+ * this generator is [bit-docs-generate-html/html].
+ * 
+ * This plugin handles the `html` hook, which allows other plugins to hook into
+ * the generation process, to do things like include their own static assets,
+ * or provide their own mustache templates.
+ * 
+ * This plugin provides a default set of mustache templates and static assets.
+ * These mustache templates and less styles can be copied over into a theme
+ * plugin and customized. Any custom mustache template will override a default
+ * of the same name.
  */
 module.exports = function(bitDocs){
     bitDocs.register("generator", generator);