From e9f2587a92575cac31bc1d4ae944e17c09756659 Mon Sep 17 00:00:00 2001
From: Christoph Tavan <dev@tavan.de>
Date: Tue, 23 Jun 2020 22:43:54 +0200
Subject: [PATCH] docs: document jspm usage (#473)

Thanks to pkg.exports this module is now well-supported by
https://jspm.org/ without any Node.js crypto api polyfills for the
browser.
---
 README.md    | 19 ++++++++++++++++---
 README_js.md | 19 ++++++++++++++++---
 2 files changed, 32 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index b9a7aa6f..d5e26ab8 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@ For the creation of [RFC4122](http://www.ietf.org/rfc/rfc4122.txt) UUIDs
 
 - **Complete** - Support for RFC4122 version 1, 3, 4, and 5 UUIDs
 - **Cross-platform** - Support for ...
-  - CommonJS, [ECMAScript Modules](#ecmascript-modules) and [CDN builds (UMD)](#cdn-builds-umd)
+  - CommonJS, [ECMAScript Modules](#ecmascript-modules) and [CDN builds](#cdn-builds)
   - Node 8, 10, 12, 14
   - Chrome, Safari, Firefox, Edge, IE 11 browsers
   - Webpack and rollup.js module bundlers
@@ -305,9 +305,22 @@ To run the examples you must first create a dist build of this library in the mo
 npm run build
 ```
 
-## CDN Builds (UMD)
+## CDN Builds
 
-This module may be loaded directly into a browser from any of the following CDNs:
+### ECMAScript Modules
+
+To load this module directly into modern browsers that [support loading ECMAScript Modules](https://caniuse.com/#feat=es6-module) you can make use of [jspm](https://jspm.org/):
+
+```html
+<script type="module">
+  import { v4 as uuidv4 } from 'https://jspm.dev/uuid';
+  console.log(uuidv4()); // ⇨ '1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed'
+</script>
+```
+
+### UMD
+
+To load this module directly into older browsers you can use the [UMD (Universal Module Definition)](https://github.com/umdjs/umd) builds from any of the following CDNs:
 
 **Using [UNPKG](https://unpkg.com/uuid@latest/dist/umd/)**:
 
diff --git a/README_js.md b/README_js.md
index b26dd83f..9241fd8c 100644
--- a/README_js.md
+++ b/README_js.md
@@ -20,7 +20,7 @@ For the creation of [RFC4122](http://www.ietf.org/rfc/rfc4122.txt) UUIDs
 
 - **Complete** - Support for RFC4122 version 1, 3, 4, and 5 UUIDs
 - **Cross-platform** - Support for ...
-  - CommonJS, [ECMAScript Modules](#ecmascript-modules) and [CDN builds (UMD)](#cdn-builds-umd)
+  - CommonJS, [ECMAScript Modules](#ecmascript-modules) and [CDN builds](#cdn-builds)
   - Node 8, 10, 12, 14
   - Chrome, Safari, Firefox, Edge, IE 11 browsers
   - Webpack and rollup.js module bundlers
@@ -294,9 +294,22 @@ To run the examples you must first create a dist build of this library in the mo
 npm run build
 ```
 
-## CDN Builds (UMD)
+## CDN Builds
 
-This module may be loaded directly into a browser from any of the following CDNs:
+### ECMAScript Modules
+
+To load this module directly into modern browsers that [support loading ECMAScript Modules](https://caniuse.com/#feat=es6-module) you can make use of [jspm](https://jspm.org/):
+
+```html
+<script type="module">
+  import { v4 as uuidv4 } from 'https://jspm.dev/uuid';
+  console.log(uuidv4()); // ⇨ '1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed'
+</script>
+```
+
+### UMD
+
+To load this module directly into older browsers you can use the [UMD (Universal Module Definition)](https://github.com/umdjs/umd) builds from any of the following CDNs:
 
 **Using [UNPKG](https://unpkg.com/uuid@latest/dist/umd/)**: