Start with documentation schema validation. Refs #398

Author: tmcw

package.json

@@ -24,13 +24,13 @@
     "disparity": "^2.0.0",
     "doctrine": "^1.1.0",
     "documentation-theme-utils": "^3.0.0",
-    "lodash": "^4.11.1",
     "events": "^1.1.0",
     "extend": "^3.0.0",
     "get-comments": "^1.0.1",
     "git-url-parse": "^6.0.1",
     "highlight.js": "^9.1.0",
     "js-yaml": "^3.3.1",
+    "lodash": "^4.11.1",
     "mdast-util-inject": "^1.1.0",
     "micromatch": "^2.1.6",
     "mime": "^1.3.4",
@@ -58,7 +58,9 @@
     "chdir": "0.0.0",
     "eslint": "^2.0.0",
     "fs-extra": "^0.30.0",
+    "documentation-schema": "0.0.1",
     "glob": "^7.0.0",
+    "json-schema": "0.2.2",
     "mock-fs": "^3.5.0",
     "tap": "^5.4.4",
     "tmp": "0.0.28"

test/test.js

@@ -1,6 +1,8 @@
 'use strict';
 
 var test = require('tap').test,
+  documentationSchema = require('documentation-schema'),
+  validate = require('json-schema'),
   documentation = require('../'),
   outputMarkdown = require('../lib/output/markdown.js'),
   outputMarkdownAST = require('../lib/output/markdown_ast.js'),
@@ -147,6 +149,11 @@ test('outputs', function (ttt) {
 
         tt.test('JSON', function (t) {
           normalize(result);
+          result.forEach(function (comment) {
+            validate(comment, documentationSchema.jsonSchema).errors.forEach(function (error) {
+              t.ifError(error);
+            });
+          });
           var outputfile = file.replace('.input.js', '.output.json');
           if (UPDATE) {
             fs.writeFileSync(outputfile, JSON.stringify(result, null, 2));