Merge pull request #6256 from HabitRPG/api-v3-apidoc

API v3 - apidoc wip

tasks/gulp-apidoc.js

@@ -0,0 +1,22 @@
+import gulp from 'gulp';
+import clean from 'rimraf';
+import apidoc from 'apidoc';
+
+const APIDOC_DEST_PATH = './website/public/apidoc';
+const APIDOC_SRC_PATH = './website/src';
+gulp.task('apidoc:clean', (done) => {
+  clean(APIDOC_DEST_PATH, done);
+});
+
+gulp.task('apidoc', ['apidoc:clean'], (done) => {
+  let result = apidoc.createDoc({
+    src: APIDOC_SRC_PATH,
+    dest: APIDOC_DEST_PATH,
+  });
+
+  if (result === false) {
+    done(new Error('There was a problem generating apiDoc documentation.'))
+  } else {
+    done();
+  }
+});

tasks/gulp-build.js

@@ -17,6 +17,6 @@ gulp.task('build:dev:watch', ['build:dev'], () => {
   gulp.watch(['website/public/**/*.styl', 'common/script/*']);
 });
 
-gulp.task('build:prod', ['browserify', 'prepare:staticNewStuff'], (done) => {
+gulp.task('build:prod', ['browserify', 'prepare:staticNewStuff', 'apidoc'], (done) => {
   gulp.start('grunt-build:prod', done);
 });