From 4c5a85dcc0369e7a4739b4f6147802df57df059a Mon Sep 17 00:00:00 2001
From: Timur <T1mL3arn@users.noreply.github.com>
Date: Thu, 11 May 2023 20:10:16 +1000
Subject: [PATCH 1/3] [html5 setup] new chapter about including js dependencies

---
 _docs/advanced-setup/html5.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/_docs/advanced-setup/html5.md b/_docs/advanced-setup/html5.md
index e87c8df3..73e0a707 100644
--- a/_docs/advanced-setup/html5.md
+++ b/_docs/advanced-setup/html5.md
@@ -34,6 +34,38 @@ To use an external JavaScript library with Lime, you need [Haxe externs](https:/
 
 Members of the Haxe community have already created open source externs for a number of popular JavaScript libraries, so be sure to search [Haxelib](https://lib.haxe.org/search) or [Github](https://github.com/search) to see if JS externs exist for your library before you try to create your own.
 
+### Adding dependencies
+
+The way you add external libraries can vary. Some Haxe externs are configured to use with Lime out of the box (like [haxe-simple-peer](https://github.com/ixiagames/haxe-simple-peer)), so you just use it with `<haxelib name="simple-peer" />`. Other externs may require to include appropriate js dependencies by you. There are three ways for doing so:
+
+1. Ship the library with your project as a separate file:
+
+    ```xml
+    <dependency path="js-libs/someLibrary.js" />
+    ```
+
+    `js-libs/someLibrary.js` file will be copied to `lib` directory of the compiled project. You can change the dependency export path with this config:
+
+    ```xml
+    <config:html5 dependency-path="newDirName" />
+    ```
+  
+2. Embed the library:
+  
+    ```xml
+    <dependency path="js-libs/someLibrary.js" embed="true"/>
+    ```
+
+    The content of `js-libs/someLibrary.js` will be embedded into compiled application's `.js` file.
+
+3. Add remote link to the library:
+
+    ```xml
+    <dependency name="https://unpkg.com/simple-peer@5.9.0/simplepeer.min.js" />
+    ```
+    
+    The resulted `index.html` will have an appropriate `<script>` tag.
+
 ## Forums
 
 If you encounter any problems when setting up Lime for HTML5, please visit the [forums](http://community.openfl.org/c/help).

From 14564e9224f4df16eceabd26b10c29a903d4d8b6 Mon Sep 17 00:00:00 2001
From: Timur <T1mL3arn@users.noreply.github.com>
Date: Fri, 12 May 2023 14:01:40 +1000
Subject: [PATCH 2/3] update doc

- include.xml details
- index.html details
---
 _docs/advanced-setup/html5.md | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/_docs/advanced-setup/html5.md b/_docs/advanced-setup/html5.md
index 73e0a707..58570c75 100644
--- a/_docs/advanced-setup/html5.md
+++ b/_docs/advanced-setup/html5.md
@@ -36,7 +36,7 @@ Members of the Haxe community have already created open source externs for a num
 
 ### Adding dependencies
 
-The way you add external libraries can vary. Some Haxe externs are configured to use with Lime out of the box (like [haxe-simple-peer](https://github.com/ixiagames/haxe-simple-peer)), so you just use it with `<haxelib name="simple-peer" />`. Other externs may require to include appropriate js dependencies by you. There are three ways for doing so:
+To actually use external JS libraries you must include them in `Project.xml`. There are three options:
 
 1. Ship the library with your project as a separate file:
 
@@ -44,10 +44,10 @@ The way you add external libraries can vary. Some Haxe externs are configured to
     <dependency path="js-libs/someLibrary.js" />
     ```
 
-    `js-libs/someLibrary.js` file will be copied to `lib` directory of the compiled project. You can change the dependency export path with this config:
+    `js-libs/someLibrary.js` file will be copied to `lib` directory of the compiled project. You can change the dependency export path (e.g. from `lib` to `js`) with this config:
 
     ```xml
-    <config:html5 dependency-path="newDirName" />
+    <config:html5 dependency-path="js" />
     ```
   
 2. Embed the library:
@@ -66,6 +66,14 @@ The way you add external libraries can vary. Some Haxe externs are configured to
     
     The resulted `index.html` will have an appropriate `<script>` tag.
 
+### `index.html` template
+
+Another possible way of adding JS files is to link them directly inside your custom `index.html` template. With this you must [configure](../../project-files/xml-format/#template) `Poject.xml` to use a custom template and probably handle copying JS files to the project export directory by yourself. Similar to `<dependency />` but less convenient.
+
+### `include.xml`
+
+Some Haxe externs are configured to use with Lime out of the box, like [haxe-simple-peer](https://github.com/ixiagames/haxe-simple-peer). You just include it with `<haxelib name="simple-peer" />` and that's all. This works because it has [include.xml](../../project-files/xml-format/#includexml) with `<dependency />` tag so Lime knows how to include the external `simplepeer.min.js` file.
+
 ## Forums
 
 If you encounter any problems when setting up Lime for HTML5, please visit the [forums](http://community.openfl.org/c/help).

From 2ab23d90876b38979fd36be052292eb66674af0d Mon Sep 17 00:00:00 2001
From: player-03 <player3.14@gmail.com>
Date: Tue, 17 Oct 2023 15:48:23 -0400
Subject: [PATCH 3/3] Update formatting and wording.

---
 _docs/advanced-setup/html5.md | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/_docs/advanced-setup/html5.md b/_docs/advanced-setup/html5.md
index 58570c75..9a7724f5 100644
--- a/_docs/advanced-setup/html5.md
+++ b/_docs/advanced-setup/html5.md
@@ -2,7 +2,7 @@
 title: Setup HTML5
 ---
 
-Lime and OpenFL may be used to create [HTML5](https://developer.mozilla.org/en-US/docs/Glossary/HTML5) applications and games for web browsers by [compiling to JavaScript](https://haxe.org/manual/target-javascript.html)
+Lime and OpenFL may be used to create [HTML5](https://developer.mozilla.org/en-US/docs/Glossary/HTML5) applications and games for web browsers by [compiling to JavaScript](https://haxe.org/manual/target-javascript.html).
 
 ## Automatic Install
 
@@ -36,7 +36,7 @@ Members of the Haxe community have already created open source externs for a num
 
 ### Adding dependencies
 
-To actually use external JS libraries you must include them in `Project.xml`. There are three options:
+To actually use external JS libraries you must include them in _project.xml_. There are three options:
 
 1. Ship the library with your project as a separate file:
 
@@ -44,7 +44,7 @@ To actually use external JS libraries you must include them in `Project.xml`. Th
     <dependency path="js-libs/someLibrary.js" />
     ```
 
-    `js-libs/someLibrary.js` file will be copied to `lib` directory of the compiled project. You can change the dependency export path (e.g. from `lib` to `js`) with this config:
+    The _js-libs/someLibrary.js_ file will be copied into the compiled project's _lib_ directory. You can change the dependency export path (e.g. from _lib_ to _js_) with this config:
 
     ```xml
     <config:html5 dependency-path="js" />
@@ -56,23 +56,23 @@ To actually use external JS libraries you must include them in `Project.xml`. Th
     <dependency path="js-libs/someLibrary.js" embed="true"/>
     ```
 
-    The content of `js-libs/someLibrary.js` will be embedded into compiled application's `.js` file.
+    The content of _js-libs/someLibrary.js_ will be embedded into compiled application's _.js_ file.
 
-3. Add remote link to the library:
+3. Add a remote link to the library:
 
     ```xml
     <dependency name="https://unpkg.com/simple-peer@5.9.0/simplepeer.min.js" />
     ```
     
-    The resulted `index.html` will have an appropriate `<script>` tag.
+    The resulting _index.html_ will have an appropriate `<script>` tag.
 
-### `index.html` template
+### _index.html_ template
 
-Another possible way of adding JS files is to link them directly inside your custom `index.html` template. With this you must [configure](../../project-files/xml-format/#template) `Poject.xml` to use a custom template and probably handle copying JS files to the project export directory by yourself. Similar to `<dependency />` but less convenient.
+Another possible way of adding JS files is to link them directly inside your custom _index.html_ template. With this you must [configure _project.xml_ to use a custom template](../../project-files/xml-format/#template) and probably handle copying JS files to the project export directory by yourself. Similar to `<dependency />` but less convenient.
 
-### `include.xml`
+### _include.xml_
 
-Some Haxe externs are configured to use with Lime out of the box, like [haxe-simple-peer](https://github.com/ixiagames/haxe-simple-peer). You just include it with `<haxelib name="simple-peer" />` and that's all. This works because it has [include.xml](../../project-files/xml-format/#includexml) with `<dependency />` tag so Lime knows how to include the external `simplepeer.min.js` file.
+Some Haxe externs support Lime out of the box, like [haxe-simple-peer](https://github.com/ixiagames/haxe-simple-peer). You just include it with `<haxelib name="simple-peer" />` and that's all. This works because it has an [_include.xml_](../../project-files/xml-format/#includexml) file with a `<dependency />` tag so Lime knows how to include the external _simplepeer.min.js_ file.
 
 ## Forums