doc: add YAML parsers for removed sections

Author: SirR4T

doc/api/errors.md

@@ -1855,6 +1855,7 @@ A module file could not be resolved while attempting a [`require()`][] or
 ### ERR_FS_WATCHER_ALREADY_STARTED
 <!-- YAML
 added: v10.0.0
+removed: v10.8.0
 -->
 An attempt was made to start a watcher returned by `fs.watch()` that has
 already been started.
@@ -1863,6 +1864,7 @@ already been started.
 ### ERR_FS_WATCHER_NOT_STARTED
 <!-- YAML
 added: v10.0.0
+removed: v10.8.0
 -->
 
 An attempt was made to initiate operations on a watcher returned by

tools/doc/common.js

@@ -34,6 +34,10 @@ function extractAndParseYAML(text) {
     meta.deprecated = arrify(meta.deprecated);
   }
 
+  if (meta.removed) {
+    meta.removed = arrify(meta.removed);
+  }
+
   meta.changes = meta.changes || [];
 
   return meta;

tools/doc/html.js

@@ -264,6 +264,7 @@ function parseYAML(text) {
 
   const added = { description: '' };
   const deprecated = { description: '' };
+  const removed = { description: '' };
 
   if (meta.added) {
     added.version = meta.added.join(', ');
@@ -276,9 +277,15 @@ function parseYAML(text) {
         `<span>Deprecated since: ${deprecated.version}</span>`;
   }
 
+  if (meta.removed) {
+    removed.version = meta.removed.join(', ');
+    removed.description = `<span>Removed in: ${removed.version}</span>`;
+  }
+
   if (meta.changes.length > 0) {
     if (added.description) meta.changes.push(added);
     if (deprecated.description) meta.changes.push(deprecated);
+    if (removed.description) meta.changes.push(removed);
 
     meta.changes.sort((a, b) => versionSort(a.version, b.version));
 
@@ -299,7 +306,8 @@ function parseYAML(text) {
 
     result += '</table>\n</details>\n';
   } else {
-    result += `${added.description}${deprecated.description}\n`;
+    result += `${added.description}${deprecated.description}` +
+              `${removed.description}\n`;
   }
 
   if (meta.napiVersion) {