Added doc generation task and root doc

Author: wingedfox

Gruntfile.js

@@ -50,6 +50,14 @@ module.exports = function(grunt) {
                     autoWatch: false,
                     singleRun: true
                 }
+            },
+            angular15: {
+                options: {
+                    keepalive: true,
+                    configFile: 'karma-angular-1.5.conf.js',
+                    autoWatch: false,
+                    singleRun: true
+                }
             }
         },
 
@@ -59,15 +67,33 @@ module.exports = function(grunt) {
                     prop: 'gitdescribe'
                 }
             }
+        },
+
+        "dgeni-alive": {
+            options: {
+                  serve: {
+                      port: '10000',
+                      openBrowser: false
+                  },
+            },
+            api: {
+                  expand: false,
+                  src: [
+                      'src/**/*.js',
+                      'docs/**/*.ngdoc'
+                  ],
+                  dest: 'build/docs'
+            }
         }
-        
+
     });
 
     grunt.loadNpmTasks('grunt-contrib-concat');
     grunt.loadNpmTasks('grunt-contrib-uglify');
     grunt.loadNpmTasks('grunt-karma');
     grunt.loadNpmTasks('grunt-git-describe');
-        
+    grunt.loadNpmTasks('dgeni-alive');
+
     grunt.registerTask('default', ['concat:prod']);
     grunt.registerTask('prod', ['git-describe:run', 'concat:prod', 'uglify']);
 };

docs/api/index.ngdoc

@@ -0,0 +1,14 @@
+@ngdoc overview
+@name API Reference
+@description
+
+# Angular-route-segment API Docs
+Welcome to the angular-route-segment API docs page. These pages contain the reference materials for version <strong ng-bind="version"></strong>.
+
+## Modules
+
+## {@link route-segment route-segment (routing module)}
+Module defines routing configuration.
+
+## {@link view-segment view-segment (presentation module)}
+Module defines routing views and helper components.