Absolute depth change is ok.

isaacs · isaacs · commit 6624e840101d · 2012-02-16T01:23:51.000-08:00
It's only depth *increase* of greater than 1 that's bad.
diff --git a/tools/doc/html.js b/tools/doc/html.js
@@ -58,7 +58,7 @@ function buildToc(lexed, filename, cb) {
   var depth = 0;
   lexed.forEach(function(tok) {
     if (tok.type !== 'heading') return;
-    if (Math.abs(tok.depth - depth) > 1) {
+    if (tok.depth - depth > 1) {
       return cb(new Error('Inappropriate heading level\n' +
                           JSON.stringify(tok)));
     }
diff --git a/tools/doc/json.js b/tools/doc/json.js
@@ -30,7 +30,7 @@ function doJSON(input, filename, cb) {
 
     if (type === 'heading' &&
         !text.trim().toLowerCase().match(/^example/)) {
-      if (Math.abs(tok.depth - depth) > 1) {
+      if (tok.depth - depth > 1) {
         return cb(new Error('Inappropriate heading level\n'+
                             JSON.stringify(tok)));
       }

Original file line number	Diff line number	Diff line change
`@@ -58,7 +58,7 @@ function buildToc(lexed, filename, cb) {`
`58`	`58`	`var depth = 0;`
`59`	`59`	`lexed.forEach(function(tok) {`
`60`	`60`	`if (tok.type !== 'heading') return;`
`61`		`- if (Math.abs(tok.depth - depth) > 1) {`
	`61`	`+ if (tok.depth - depth > 1) {`
`62`	`62`	`return cb(new Error('Inappropriate heading level\n' +`
`63`	`63`	`JSON.stringify(tok)));`
`64`	`64`	`}`
Original file line number	Diff line number	Diff line change
`@@ -30,7 +30,7 @@ function doJSON(input, filename, cb) {`
`30`	`30`
`31`	`31`	`if (type === 'heading' &&`
`32`	`32`	`!text.trim().toLowerCase().match(/^example/)) {`
`33`		`- if (Math.abs(tok.depth - depth) > 1) {`
	`33`	`+ if (tok.depth - depth > 1) {`
`34`	`34`	`return cb(new Error('Inappropriate heading level\n'+`
`35`	`35`	`JSON.stringify(tok)));`
`36`	`36`	`}`