From cd03675995094f2b2b50b454bdc18e01eddadf5a Mon Sep 17 00:00:00 2001
From: kor <kor@dwarshuis.com>
Date: Sun, 21 Jul 2024 18:59:10 +0200
Subject: [PATCH] Instructions for developers

---
 public/js/README.md | 57 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 public/js/README.md

diff --git a/public/js/README.md b/public/js/README.md
new file mode 100644
index 0000000..ba5f905
--- /dev/null
+++ b/public/js/README.md
@@ -0,0 +1,57 @@
+# How to for developers
+
+The Kerific extension is build in Vue.js. Vue.js is used for packing, compressing etc.
+
+The files for the extension are to be found in:
+`/src`
+`/public`
+
+# Description of the files and their function
+
+## External libraries, frameworks etc
+
+### turndown.js
+
+“Convert HTML into Markdown with JavaScript.”
+
+<https://github.com/mixmark-io/turndown>
+
+### Bootstrap
+
+“Bootstrap is a powerful, feature-packed frontend toolkit. Build anything—from prototype to production—in minutes.”
+
+<https://getbootstrap.com/docs/5.3/getting-started/introduction/>
+
+### DOMPurify
+
+“DOMPurify is a DOM-only, super-fast, uber-tolerant XSS sanitizer for HTML, MathML and SVG.”
+
+<https://github.com/cure53/DOMPurify>
+
+## Internal scripts
+
+### main.js
+
+`/src/main.js
+
+JavaScript that handles the main functionality: fetching external libraries and show them in a modal in the target page.
+
+### collection.js
+
+`/public/js/collection.js`
+
+JavaScript that handles the collection page (collection.html).
+
+### options.js
+
+`/public/js/options.js`
+
+JavaScript that handles the options page (options.html).
+
+## How to
+
+`/dist` is the build that is the source for the extension. This directory should be zipped and uploaded to the developers section of the [Chrome Web Store Developer Dashboard](https://chrome.google.com/u/1/webstore/devconsole/)
+
+The references in manifest.json point to files in this final distribution.
+
+`/dist` is generated from source via `npm run build`.