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