remove redundant self-reference in documentation

The link is relevant in the API.md, but superfluous in the generated
HTML documentation. Hence, it's removed where the HTML documentation
is generated.

Author: warm-coolguy

packages/clients/afm/API.md

@@ -2,6 +2,8 @@
 
 This is a default compilation of POLAR feature packages for online services. This document and its child documents describe the setup.
 
+For all additional details, check the [full documentation](https://dataport.github.io/polar/docs/afm/client-afm.html).
+
 ## Requirements
 
 To understand this document, programming knowledge (preferably in JavaScript) are required. This is a technical document describing how to integrate the map client with its programmatic API.

packages/clients/snowbox/API.md

@@ -3,3 +3,5 @@
 This is an API file that is used as part of the generated documentation. It will appear as main document in the snowbox's documentation.
 
 If the snowbox implemented any own features that are not derived from either core of plugins, this would be the place to document them. However, since that's not the case, it only features this introduction text and the link list below.
+
+For all additional details, check the [full documentation](https://dataport.github.io/polar/docs/snowbox/client-snowbox.html).

scripts/makeDocs.js

@@ -84,6 +84,29 @@ function toHtml(filePath, children) {
 </html>`
 }
 
+/**
+ * Removes documentation page link from documentation page; it's only relevant
+ * when reading the API.md directly, not on this page.
+ * @param {string} html the html'd API.md
+ * @returns {string} html without the link to itself
+ */
+const filter = (html) => {
+  const filterRegex =
+    /<p>For all additional details, check the <a href=".*">full documentation<\/a>.<\/p>/g
+
+  const matches = (html.match(filterRegex) || []).length
+
+  if (matches !== 1) {
+    console.error(html)
+
+    throw new Error(
+      `makeDocs.js expected to remove a self-reference in HTML generated from an API.md with exactly one match, but found ${matches} matches. This indicates an unexpected change in the API.md.`
+    )
+  }
+
+  return html.replace(filterRegex, '')
+}
+
 const getDistinguishingFileNameFromPath = (path) => path.split('/').slice(-1)[0]
 
 const dependencyPaths = fs
@@ -99,13 +122,15 @@ fs.readdirSync(docPath).forEach((f) => fs.rmSync(`${docPath}/${f}`))
 ;[clientPath, ...dependencyPaths].forEach((path) => {
   const isMain = path === clientPath
   const markdownFile = `${path}/${isMain ? 'API.md' : 'README.md'}`
-  const html = toHtml(
-    markdownFile,
-    isMain
-      ? dependencyPaths.map(
-          (path) => getDistinguishingFileNameFromPath(path) + '.html'
-        )
-      : null
+  const html = (isMain ? filter : (x) => x)(
+    toHtml(
+      markdownFile,
+      isMain
+        ? dependencyPaths.map(
+            (path) => getDistinguishingFileNameFromPath(path) + '.html'
+          )
+        : null
+    )
   )
   const targetName = `${
     path === clientPath ? 'client-' : ''