Updates from reviewing PR

Author: stocaaro

.github/workflows/update_references.yml

@@ -2,6 +2,13 @@ import { writeFileSync, readFileSync } from 'fs';
 import { packageCategories } from '../src/data/api-categories.mjs';
 import { processReferences } from '../src/data/process-typedoc.mjs';
 
+/**
+ * The purpose of this script is to create generate an object that only contains
+ * the desired category nodes and every node needed to generate the api documentation
+ * for these nodes.  This is done by iterating over the needed category nodes and
+ * then recursively adding every node found into cleanReferences.
+ */
+
 /**
  * Read the -p flag from the cli params
  *