From 995f2fbf00d86b6c152c10cc0a5664c3b1056818 Mon Sep 17 00:00:00 2001
From: Guillaume Grossetie <ggrossetie@gmail.com>
Date: Sun, 2 Jun 2024 09:53:50 +0200
Subject: [PATCH] Update browser setup

We are now using ESM.
---
 docs/modules/setup/pages/install.adoc | 20 ++++++++++++++------
 1 file changed, 14 insertions(+), 6 deletions(-)

diff --git a/docs/modules/setup/pages/install.adoc b/docs/modules/setup/pages/install.adoc
index d8f74d486..c8618ea3a 100644
--- a/docs/modules/setup/pages/install.adoc
+++ b/docs/modules/setup/pages/install.adoc
@@ -23,16 +23,24 @@ See below for a link to the right one and instructions on how to use it.
 
 == Basic browser setup
 
-Include Asciidoctor.js in a `<script>` tag.
-You can instantiate the processor using the `Asciidoctor` global variable.
+Import Asciidoctor.js in a `<script type="module">` tag.
+You can instantiate the processor using the `Asciidoctor()`.
 
 ```html
-<script src="node_modules/@asciidoctor/core/dist/browser/asciidoctor.js"></script>
-```
-```js
-var asciidoctor = Asciidoctor()
+<script type="module">
+  import Asciidoctor from './node_modules/@asciidoctor/core/dist/browser/asciidoctor.js'
+  const asciidoctor = Asciidoctor()
+</script>
 ```
 
+[NOTE]
+====
+You need to pay attention to local testing — if you try to load the HTML file locally (i.e. with a file:// URL), you'll run into CORS errors due to JavaScript module security requirements.
+You need to do your testing through a server. 
+
+Learn more about https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules[JavaScript modules].
+====
+
 == Node
 
 ```js