Included nest module to the lint documentation.

Check on parent element: foo.bar sub-parametr should be documeted with parent.
Fixed documentationjs#832 issue

Author: anthony-redFox

__tests__/lib/lint.js

@@ -28,6 +28,14 @@ test('lintComments', function() {
     { message: 'Missing or invalid tag name' }
   ]);
 
+  expect(
+    evaluate(function() {
+      /**
+      * @param {Object} foo.bar
+      */
+    }).errors
+  ).toEqual([{ message: 'Parent of foo.bar not found' }]);
+
   expect(
     evaluate(function() {
       /**

src/lint.js

@@ -4,6 +4,7 @@ var VFile = require('vfile');
 import { walk } from './walk';
 import vfileSort from 'vfile-sort';
 import reporter from 'vfile-reporter';
+import nest from './nest';
 
 var CANONICAL = {
   String: 'string',
@@ -27,11 +28,8 @@ function lintComments(comment: Comment) {
     function nameInvariant(name) {
       if (name && typeof CANONICAL[name] === 'string') {
         comment.errors.push({
-          message: 'type ' +
-            name +
-            ' found, ' +
-            CANONICAL[name] +
-            ' is standard',
+          message:
+            'type ' + name + ' found, ' + CANONICAL[name] + ' is standard',
           commentLineNumber: tag.lineNumber
         });
       }
@@ -60,6 +58,13 @@ function lintComments(comment: Comment) {
       checkCanonical(tag.type);
     }
   });
+
+  try {
+    nest(comment);
+  } catch (error) {
+    comment.errors.push({ message: error.message });
+  }
+
   return comment;
 }