From 6ade4536f7e243de129973a34dfc834d1429b479 Mon Sep 17 00:00:00 2001
From: Erik Westrup <erik.westrup@gmail.com>
Date: Fri, 23 Jul 2021 15:30:38 +0200
Subject: [PATCH] Add instructions on how to unminify main.js for easier
 browser debugging (#3055)

* Add instructions on how to unminify main.js for easier browser debugging

* Fixed Markdown style like sggested by @iBug
---
 docs/_docs/17-javascript.md | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/_docs/17-javascript.md b/docs/_docs/17-javascript.md
index 072fc3f92cc2..689fd90a2f81 100644
--- a/docs/_docs/17-javascript.md
+++ b/docs/_docs/17-javascript.md
@@ -64,3 +64,18 @@ To get started:
 {: .notice--warning}
 
 If all goes well, running `npm run build:js` will compress/concatenate `_main.js` and all plugin scripts into `main.min.js`.
+
+## Debugging
+The minified Javascript is harder to debug in the browser than the raw source. To stop the minification and just bundle all the Javascript as-is; open up `package.json` and edit the value `scripts.uglify` from:
+
+```json
+  "scripts": {
+    "uglify": "uglifyjs [...] -c -m -o assets/js/main.min.js",
+```
+
+to simply concatenating the files:
+
+```json
+  "scripts": {
+    "uglify": "cat [...] > assets/js/main.min.js",
+```