From c9ee4d34b3c6d3e08033c039dcabd010dfa85059 Mon Sep 17 00:00:00 2001
From: ST-DDT <ST-DDT@gmx.de>
Date: Tue, 28 May 2024 20:45:45 +0200
Subject: [PATCH] docs: apply suggestions

---
 docs/guide/usage.md | 29 ++++++++++++++++++-----------
 test.html           | 15 +++++++++++++++
 2 files changed, 33 insertions(+), 11 deletions(-)
 create mode 100644 test.html

diff --git a/docs/guide/usage.md b/docs/guide/usage.md
index 362a3d731c9..4acf111ece4 100644
--- a/docs/guide/usage.md
+++ b/docs/guide/usage.md
@@ -30,6 +30,18 @@ For more information on selecting and customizing a locale, please refer to our
 
 ## Browser
 
+If you want to try it yourself, you can open your browser console via `Ctrl + Shift + J` / `F12`.
+
+```js
+const { faker } = await import('https://esm.sh/@faker-js/faker');
+
+const randomName = faker.person.fullName(); // Amber Keebler
+const randomEmail = faker.internet.email(); // Norma13@hotmail.com
+```
+
+Some websites may have protections against downloading external code, dev servers usually work fine.
+As an alternative, you can create a simple html file and open it with your browser:
+
 ```html
 <script type="module">
   import { faker } from 'https://esm.sh/@faker-js/faker';
@@ -39,24 +51,19 @@ For more information on selecting and customizing a locale, please refer to our
 
   // Rusty@arne.info
   const randomEmail = faker.internet.email();
+
+  document.getElementById('name').value = randomName;
+  document.getElementById('email').value = randomEmail;
 </script>
+
+<input id="name" />
+<input id="email" />
 ```
 
 ::: info Note
 Using the browser is great for experimenting 👍. However, due to all of the strings Faker uses to generate fake data, **Faker is a large package**. It's `> 5 MiB` minified. **Please avoid deploying the full Faker in your web app.**
 :::
 
-## Browser Console
-
-If you want to try it yourself, you can open your browser console via `Ctrl + Shift + J` / `F12`.
-
-```js
-const { faker } = await import('https://esm.sh/@faker-js/faker');
-
-const randomName = faker.person.fullName(); // Amber Keebler
-const randomEmail = faker.internet.email(); // Norma13@hotmail.com
-```
-
 ## CDN/Deno
 
 ```js
diff --git a/test.html b/test.html
new file mode 100644
index 00000000000..93b6cb99f63
--- /dev/null
+++ b/test.html
@@ -0,0 +1,15 @@
+<script type="module">
+  import { faker } from 'https://esm.sh/@faker-js/faker';
+
+  // Caitlyn Kerluke
+  const randomName = faker.person.fullName();
+
+  // Rusty@arne.info
+  const randomEmail = faker.internet.email();
+
+  document.getElementById('name').value = randomName;
+  document.getElementById('email').value = randomEmail;
+</script>
+
+<input id="name" />
+<input id="email" />