website: add comments to duo of plugin docs zip fns

website/components/remote-plugin-docs/utils/parse-docs-zip.js

@@ -2,6 +2,12 @@ const path = require('path')
 const AdmZip = require('adm-zip')
 const validatePluginDocsFiles = require('./validate-plugin-docs-files')
 
+/*
+
+NOTE: used for default `docs.zip` release assets
+
+*/
+
 // Given a response from fetching a docs.zip file,
 // which is a compressed "docs" folder,
 //

website/components/remote-plugin-docs/utils/parse-source-zip.js

@@ -2,6 +2,13 @@ const path = require('path')
 const AdmZip = require('adm-zip')
 const validatePluginDocsFiles = require('./validate-plugin-docs-files')
 
+/*
+
+NOTE: used for fallback approach, where we parse from
+the full release archive
+
+*/
+
 // Given a response from fetching a source .zip file,
 // which contains a "docs" folder,
 //