tools: produce JSON documentation using unified/remark/rehype

Further progress trying to produce JSON with remark
premature to remove marked entirely
... but we can update to the latest :-)
nodejs · rubys · rubys · rubys · Jul 7, 2018 · nodejs-github-bot
diff --git a/tools/doc/json2.js b/tools/doc/json2.js
@@ -0,0 +1,491 @@
+// Copyright Joyent, Inc. and other Node contributors.
diff --git a/tools/doc/json.js b/tools/doc/json.js
+    const metaExpr = /<!--([^=]+)=([^-]+)-->\n*/g;
+    const stabilityExpr = /^Stability: ([0-5])(?:\s*-\s*)?(.*)$/s;
+
+    // extract definitions
diff --git a/tools/doc/json.js b/tools/doc/json.js
+      // Extract (and remove) metadata that is not directly inferable
+      // from the markdown itself.
+      nodes.forEach((node, i) => {
+        // Input: <!-- name=module -->; output: {name: module}
diff --git a/tools/doc/json.js b/tools/doc/json.js
-        values.push(item);
-        current = item;
+      // Pluralize type to determine which 'bucket' to put this section
+      // in.
diff --git a/tools/doc/json.js b/tools/doc/json.js

-  delete section.list;
+      // Add this section to the parent.  Sometimes we have two headings with a
diff --git a/tools/doc/json.js b/tools/doc/json.js

-  delete section.list;
+      // Add this section to the parent.  Sometimes we have two headings with a
+      // single blob of description.  If the preceding entry at this level
diff --git a/tools/doc/json.js b/tools/doc/json.js
-        ` > ${text}`
-      );
+
+    // At this point, the name should match.  If it doesn't find one that does.
diff --git a/tools/doc/json.js b/tools/doc/json.js
-      }
-      return;
-    }
+        // Stablility marker: > Stability: ...
diff --git a/tools/doc/json.js b/tools/doc/json.js
-  return src;
-}
-
-
 // This section parse out the contents of an H# tag.

 // To reduse escape slashes in RegExp string components.
diff --git a/tools/doc/json.js b/tools/doc/json.js
-  return src;
-}
-
-
 // This section parse out the contents of an H# tag.