From bd7be07ad3031ff0c635738ba28aaf9c777dc70c Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Tue, 11 Jun 2024 19:25:42 -0700
Subject: [PATCH 01/32] Resolving merge conflicts

---
 src/guitar-diagrams-config.mjs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/guitar-diagrams-config.mjs b/src/guitar-diagrams-config.mjs
index 73a46ca..3b04fd0 100644
--- a/src/guitar-diagrams-config.mjs
+++ b/src/guitar-diagrams-config.mjs
@@ -63,16 +63,16 @@ export class GuitarDiagramsJSConfig {
     // ========== BEGIN properties
     // ----- References
     /**
-     * Gets the ID attribute of the canvas HTML tag.
-     * @return {string} The ID attribute of the canvas HTML tag.
+     * Gets the ID attribute of the canvas HTML element.
+     * @return {string} The ID attribute of the canvas HTML element.
      */
     get canvasID() {
         return this.#canvasID;
     } // end get canvasID property
 
     /**
-     * Sets the ID attribute of the canvas HTML tag.
-     * @param {string} paramCanvasID - The ID attribute of the canvas HTML tag.
+     * Sets the ID attribute of the canvas HTML element.
+     * @param {string} paramCanvasID - The ID attribute of the canvas HTML element.
      */
     set canvasID(paramCanvasID) {
         this.#canvasID = paramCanvasID;
@@ -104,7 +104,7 @@ export class GuitarDiagramsJSConfig {
     } // end get colorNut property
 
     /**
-     * Gets the HTML color code of the nut.
+     * Sets the HTML color code of the nut.
      * @param {string} paramColorNut - The HTML color code of the nut.
      */
     set colorNut(paramColorNut) {
@@ -120,7 +120,7 @@ export class GuitarDiagramsJSConfig {
     } // end get colorNutOutline property
 
     /**
-     * Gets the HTML color code of the nut outline.
+     * Sets the HTML color code of the nut outline.
      * @param {string} paramColorNutOutline - The HTML color code of the nut outline.
      */
     set colorNutOutline(paramColorNutOutline) {

From 1fd9a2c8135522b1ac5432ed4889469428a43799 Mon Sep 17 00:00:00 2001
From: Chad Kreiger <ckreiger1@gmail.com>
Date: Fri, 31 May 2024 19:23:51 -0700
Subject: [PATCH 02/32] CanvasID API usage - sample formatting

---
 docs/index.md | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/docs/index.md b/docs/index.md
index 7d3c92c..1b238b6 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -30,8 +30,29 @@ Lorem ipsum...
 
 ### guitar-diagrams-config.js
 
-#### guitar-diagrams-config.js Members
+### guitar-diagrams-config.js Members
 
+#### canvasID
+
+Gets and sets the ID attribute of the canvas HTML tag.
+
+- **Parameters**: {string} paramCanvasID
+- **Return Value**: #canvasID
+
+*Example:*
+
+```
+get canvasID() {
+        return this.#canvasID;
+    } // end get canvasID property
+    /**
+     * Sets the ID attribute of the canvas HTML tag.
+     * @param {string} paramCanvasID - The ID attribute of the canvas HTML tag.
+     */
+    set canvasID(paramCanvasID) {
+        this.#canvasID = paramCanvasID;
+    } // end get canvasID property'
+```
 #### guitar-diagrams-config.js Methods
 
 Lorem ipsum...

From 97a5743a1e979222039bfe94b75dae88f80c3093 Mon Sep 17 00:00:00 2001
From: Chad Kreiger <ckreiger1@gmail.com>
Date: Fri, 31 May 2024 19:31:14 -0700
Subject: [PATCH 03/32] Update to the index file sample

---
 docs/index.md | 11 +----------
 1 file changed, 1 insertion(+), 10 deletions(-)

diff --git a/docs/index.md b/docs/index.md
index 1b238b6..c0ab92f 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -42,16 +42,7 @@ Gets and sets the ID attribute of the canvas HTML tag.
 *Example:*
 
 ```
-get canvasID() {
-        return this.#canvasID;
-    } // end get canvasID property
-    /**
-     * Sets the ID attribute of the canvas HTML tag.
-     * @param {string} paramCanvasID - The ID attribute of the canvas HTML tag.
-     */
-    set canvasID(paramCanvasID) {
-        this.#canvasID = paramCanvasID;
-    } // end get canvasID property'
+gdj1.config.canvasID = 'diagram-1-canvas'; // specify the canvas element's an ID
 ```
 #### guitar-diagrams-config.js Methods
 

From b135ad6e6fb37db1b99e020787a8ff69be46f252 Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Sat, 1 Jun 2024 20:07:08 -0700
Subject: [PATCH 04/32] Updating docs formatting

---
 .../guitar-diagrams-config.mjs                |  8 +-
 docs/index.md                                 | 80 ++++++++++++++-----
 2 files changed, 62 insertions(+), 26 deletions(-)

diff --git a/docs/examples/js/guitar-diagrams-js/guitar-diagrams-config.mjs b/docs/examples/js/guitar-diagrams-js/guitar-diagrams-config.mjs
index 73a46ca..f04f4e8 100644
--- a/docs/examples/js/guitar-diagrams-js/guitar-diagrams-config.mjs
+++ b/docs/examples/js/guitar-diagrams-js/guitar-diagrams-config.mjs
@@ -63,16 +63,16 @@ export class GuitarDiagramsJSConfig {
     // ========== BEGIN properties
     // ----- References
     /**
-     * Gets the ID attribute of the canvas HTML tag.
-     * @return {string} The ID attribute of the canvas HTML tag.
+     * Gets the ID attribute of the canvas HTML element.
+     * @return {string} The ID attribute of the canvas HTML element.
      */
     get canvasID() {
         return this.#canvasID;
     } // end get canvasID property
 
     /**
-     * Sets the ID attribute of the canvas HTML tag.
-     * @param {string} paramCanvasID - The ID attribute of the canvas HTML tag.
+     * Sets the ID attribute of the canvas HTML element.
+     * @param {string} paramCanvasID - The ID attribute of the canvas HTML element.
      */
     set canvasID(paramCanvasID) {
         this.#canvasID = paramCanvasID;
diff --git a/docs/index.md b/docs/index.md
index c0ab92f..120f18b 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -20,42 +20,78 @@ Lorem ipsum...
 
 ## API Usage
 
-Lorem ipsum...
+Lorem ipsum...some description, if necessary, for the API usage section.
+
+### `guitar-diagrams.js` Class
+
+#### `guitar-diagrams.js` Constructors
+
+Constructor(s) in `guitar-diagrams.js` go here...
+
+#### `guitar-diagrams.js` Static Public Members
+
+Static members in `guitar-diagrams.js` go here... (We might need to talk about how to handled these.)
 
-### guitar-diagrams.js
+#### `guitar-diagrams.js` Public Properties
 
-#### guitar-diagrams.js Members
+Properties in `guitar-diagrams.js` go here...
 
-#### guitar-diagrams.js Methods
+#### `guitar-diagrams.js` Public Methods
 
-### guitar-diagrams-config.js
+Methods in `guitar-diagrams.js` go here...
 
-### guitar-diagrams-config.js Members
+### `guitar-diagrams-config.js` Class
 
-#### canvasID
+#### `guitar-diagrams-config.js` Constructors
 
-Gets and sets the ID attribute of the canvas HTML tag.
+Constructor(s) in `guitar-diagrams-config.js` go here...
 
-- **Parameters**: {string} paramCanvasID
-- **Return Value**: #canvasID
+#### `guitar-diagrams-config.js` Public Properties
 
-*Example:*
+Properties in `guitar-diagrams-config.js` go here...
 
+##### canvasID (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the ID attribute of the canvas HTML element.
+
+- **Parameters**: {string} The ID attribute of the canvas HTML element.
+- **Return Value**: _None_
+- **Default Value**: {string} 'gdjCanvas'
+
+_Example:_
+
+```javascript
+gdj1.config.canvasID = 'diagram-1-canvas';
 ```
-gdj1.config.canvasID = 'diagram-1-canvas'; // specify the canvas element's an ID
+
+##### canvasID (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the ID attribute of the canvas HTML element.
+
+- **Parameters**: _None_
+- **Return Value**: {string} The ID attribute of the canvas HTML element.
+- **Default Value**: {string} 'gdjCanvas'
+
+_Example:_
+
+```javascript
+console.log('Canvas ID: ' + gdj1.config.canvasID);
 ```
-#### guitar-diagrams-config.js Methods
 
-Lorem ipsum...
+#### `guitar-diagrams-config.js` Public Methods
 
-| Name | Description | Parameters | Return Value | Example | Notes |
-| ---- | ----------- | ---------- | ------------ | ------- | ----- |
-| z | y | x | w | v | u |
+_None._
 
-### Configuration Values
+### `guitar-diagrams-marker.js` Class
 
-Lorem ipsum...
+#### `guitar-diagrams-marker.js` Constructors
+
+Constructor(s) in `guitar-diagram-marker.js` go here... (There's only a default constructor as of now.)
+
+#### `guitar-diagrams-marker.js` Public Properties
+
+Properties in `guitar-diagrams-marker.js` go here...
+
+#### `guitar-diagrams-marker.js` Public Methods
 
-| Name | Description | Required | Values | Default | Example | Notes |
-| ---- | ----------- | -------- | ------ | ------- | ------- | ----- |
-| z | y | x | w | v | u | t |
+Methods in `guitar-diagrams-marker.js` go here...

From 9ff300f22f65182cce0ed87438d17ef213240592 Mon Sep 17 00:00:00 2001
From: Chad Kreiger <ckreiger1@gmail.com>
Date: Sun, 2 Jun 2024 12:11:06 -0700
Subject: [PATCH 05/32] colorFretboard example attempted

---
 docs/index.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/docs/index.md b/docs/index.md
index 120f18b..fb6f165 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -77,6 +77,33 @@ _Example:_
 ```javascript
 console.log('Canvas ID: ' + gdj1.config.canvasID);
 ```
+##### colorFretboard (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the HTML color code of the fretboard.
+
+- **Parameters**: {string} The HTML color code of the fretboard.
+- **Return Value**: _None_
+- **Default Value**: {string} '#795548'
+
+_Example:_
+
+```javascript
+gdj5.config.colorFretboard = '#FFE0B2';
+```
+
+##### colorFretboard (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the HTML color code of the fretboard.
+
+- **Parameters**: _None_
+- **Return Value**: {string} The HTML color code of the fretboard.
+- **Default Value**: {string} '#795548'
+
+_Example:_
+
+```javascript
+PENDING
+```
 
 #### `guitar-diagrams-config.js` Public Methods
 

From ca0c7013bb3d8ee88c73fadd5c9b1acab1dc607c Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Sun, 2 Jun 2024 22:41:09 -0700
Subject: [PATCH 06/32] Fixing missing line in MD

---
 docs/index.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/index.md b/docs/index.md
index fb6f165..9289773 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -77,6 +77,7 @@ _Example:_
 ```javascript
 console.log('Canvas ID: ' + gdj1.config.canvasID);
 ```
+
 ##### colorFretboard (get)
 
 Exists as a property of the config property on the GuitarDiagrams object. Gets the HTML color code of the fretboard.

From 987385b48f995de9569fd85778b9af574bde0fd7 Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Mon, 3 Jun 2024 14:27:06 -0700
Subject: [PATCH 07/32] Tweaking formatting, adding TOC

---
 docs/index.md | 90 +++++++++++++++++++++++++++++++++------------------
 1 file changed, 59 insertions(+), 31 deletions(-)

diff --git a/docs/index.md b/docs/index.md
index 9289773..74e57c9 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -22,104 +22,132 @@ Lorem ipsum...
 
 Lorem ipsum...some description, if necessary, for the API usage section.
 
-### `guitar-diagrams.js` Class
-
-#### `guitar-diagrams.js` Constructors
-
-Constructor(s) in `guitar-diagrams.js` go here...
-
-#### `guitar-diagrams.js` Static Public Members
+### Table of Contents
+
+- [Guitar Diagrams JS Documentation](#guitar-diagrams-js-documentation)
+  - [Overview](#overview)
+  - [Getting started](#getting-started)
+    - [Importing the library into your project](#importing-the-library-into-your-project)
+    - [Initializing a diagram](#initializing-a-diagram)
+    - [Creating a diagram with markers](#creating-a-diagram-with-markers)
+  - [API Usage](#api-usage)
+    - [Table of Contents](#table-of-contents)
+    - [`guitar-diagrams.js` Class](#guitar-diagramsjs-class)
+      - [`guitar-diagrams.js` Constructors (non-default)](#guitar-diagramsjs-constructors-non-default)
+      - [`guitar-diagrams.js` Static Public Members](#guitar-diagramsjs-static-public-members)
+      - [`guitar-diagrams.js` Public Properties](#guitar-diagramsjs-public-properties)
+      - [`guitar-diagrams.js` Public Methods](#guitar-diagramsjs-public-methods)
+    - [`guitar-diagrams-config.js` Class](#guitar-diagrams-configjs-class)
+      - [`guitar-diagrams-config.js` Constructors (non-default)](#guitar-diagrams-configjs-constructors-non-default)
+      - [`guitar-diagrams-config.js` Public Properties](#guitar-diagrams-configjs-public-properties)
+        - [canvasID (get)](#canvasid-get)
+        - [canvasID (set)](#canvasid-set)
+        - [colorFretboard (get)](#colorfretboard-get)
+        - [colorFretboard (set)](#colorfretboard-set)
+      - [`guitar-diagrams-config.js` Public Methods](#guitar-diagrams-configjs-public-methods)
+    - [`guitar-diagrams-marker.js` Class](#guitar-diagrams-markerjs-class)
+      - [`guitar-diagrams-marker.js` Constructors (non-default)](#guitar-diagrams-markerjs-constructors-non-default)
+      - [`guitar-diagrams-marker.js` Public Properties](#guitar-diagrams-markerjs-public-properties)
+      - [`guitar-diagrams-marker.js` Public Methods](#guitar-diagrams-markerjs-public-methods)
+
+### <a name="guitar-diagrams.js"></a>`guitar-diagrams.js` Class
+
+#### <a name="guitar-diagrams.js-constructor"></a>`guitar-diagrams.js` Constructors (non-default)
+
+Constructor(s) in `guitar-diagrams.js` go here... or _None._
+
+#### <a name="guitar-diagrams.js-static-public-members"></a>`guitar-diagrams.js` Static Public Members
 
 Static members in `guitar-diagrams.js` go here... (We might need to talk about how to handled these.)
 
-#### `guitar-diagrams.js` Public Properties
+#### <a name="guitar-diagrams.js-public-properties"></a>`guitar-diagrams.js` Public Properties
 
 Properties in `guitar-diagrams.js` go here...
 
-#### `guitar-diagrams.js` Public Methods
+#### <a name="guitar-diagrams.js-public-methods"></a>`guitar-diagrams.js` Public Methods
 
 Methods in `guitar-diagrams.js` go here...
 
-### `guitar-diagrams-config.js` Class
+### <a name="guitar-diagrams-config.js"></a>`guitar-diagrams-config.js` Class
 
-#### `guitar-diagrams-config.js` Constructors
+#### <a name="guitar-diagrams.js-constructors"></a>`guitar-diagrams-config.js` Constructors (non-default)
 
 Constructor(s) in `guitar-diagrams-config.js` go here...
 
-#### `guitar-diagrams-config.js` Public Properties
+#### <a name="guitar-diagrams.js-public-properties"></a>`guitar-diagrams-config.js` Public Properties
 
 Properties in `guitar-diagrams-config.js` go here...
 
 ##### canvasID (get)
 
-Exists as a property of the config property on the GuitarDiagrams object. Gets the ID attribute of the canvas HTML element.
+Exists as a property of the config property on the GuitarDiagrams object. Sets the ID attribute of the canvas HTML element.
 
-- **Parameters**: {string} The ID attribute of the canvas HTML element.
-- **Return Value**: _None_
+- **Parameters**: _None_
+- **Return Value**: {string} The ID attribute of the canvas HTML element.
 - **Default Value**: {string} 'gdjCanvas'
 
 _Example:_
 
 ```javascript
-gdj1.config.canvasID = 'diagram-1-canvas';
+console.log('Canvas ID: ' + gdj1.config.canvasID);
 ```
 
 ##### canvasID (set)
 
-Exists as a property of the config property on the GuitarDiagrams object. Sets the ID attribute of the canvas HTML element.
+Exists as a property of the config property on the GuitarDiagrams object. Gets the ID attribute of the canvas HTML element.
 
-- **Parameters**: _None_
-- **Return Value**: {string} The ID attribute of the canvas HTML element.
+- **Parameters**: {string} The ID attribute of the canvas HTML element.
+- **Return Value**: _None_
 - **Default Value**: {string} 'gdjCanvas'
 
 _Example:_
 
 ```javascript
-console.log('Canvas ID: ' + gdj1.config.canvasID);
+gdj1.config.canvasID = 'diagram-1-canvas';
 ```
 
 ##### colorFretboard (get)
 
 Exists as a property of the config property on the GuitarDiagrams object. Gets the HTML color code of the fretboard.
 
-- **Parameters**: {string} The HTML color code of the fretboard.
-- **Return Value**: _None_
+- **Parameters**: _None_
+- **Return Value**: {string} The HTML color code of the fretboard.
 - **Default Value**: {string} '#795548'
 
 _Example:_
 
 ```javascript
-gdj5.config.colorFretboard = '#FFE0B2';
+console.log('Fretboard color: ' + gdj5.config.colorFretboard);
 ```
 
 ##### colorFretboard (set)
 
 Exists as a property of the config property on the GuitarDiagrams object. Sets the HTML color code of the fretboard.
 
-- **Parameters**: _None_
-- **Return Value**: {string} The HTML color code of the fretboard.
+- **Parameters**: {string} The HTML color code of the fretboard.
+- **Return Value**: _None_
 - **Default Value**: {string} '#795548'
 
 _Example:_
 
 ```javascript
-PENDING
+gdj5.config.colorFretboard = '#FFE0B2';
 ```
 
-#### `guitar-diagrams-config.js` Public Methods
+#### <a name="guitar-diagrams.js-public-methods"></a>`guitar-diagrams-config.js` Public Methods
 
 _None._
 
-### `guitar-diagrams-marker.js` Class
+### <a name="guitar-diagrams-marker.js"></a>`guitar-diagrams-marker.js` Class
 
-#### `guitar-diagrams-marker.js` Constructors
+#### <a name="guitar-diagrams-marker.js-contstructors"></a>`guitar-diagrams-marker.js` Constructors (non-default)
 
 Constructor(s) in `guitar-diagram-marker.js` go here... (There's only a default constructor as of now.)
 
-#### `guitar-diagrams-marker.js` Public Properties
+#### <a name="guitar-diagrams-marker.js-public-properties">`guitar-diagrams-marker.js` Public Properties
 
 Properties in `guitar-diagrams-marker.js` go here...
 
-#### `guitar-diagrams-marker.js` Public Methods
+#### <a name="guitar-diagrams-marker.js-public-methods">`guitar-diagrams-marker.js` Public Methods
 
 Methods in `guitar-diagrams-marker.js` go here...

From cedfa63fbe24e907c2fb88a69b22f0e84c453766 Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Mon, 3 Jun 2024 15:54:54 -0700
Subject: [PATCH 08/32] Moving API Docs to api-docs.md

---
 README.md        |   2 +-
 docs/api-docs.md | 129 +++++++++++++++++++++++++++++++++++++++++++++
 docs/index.md    | 132 +----------------------------------------------
 3 files changed, 131 insertions(+), 132 deletions(-)
 create mode 100644 docs/api-docs.md

diff --git a/README.md b/README.md
index f6e059d..6e362c7 100644
--- a/README.md
+++ b/README.md
@@ -151,7 +151,7 @@ See [`docs/code-owners.md`](docs/code-owners.md) for documentation related to de
 
 There are no specific requirements<sup>[1](#footnotes)</sup> for dependencies to use Guitar Diagrams JS other than the standard browser compatibility considerations with CSS, JavaScript, and HTML 5's `<canvas>` tag. Browser compatibility for the `<canvas>` tag can be found on [the MDN `<canvas>` page](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/canvas#browser_compatibility).
 
-----
+---
 
 ## References
 
diff --git a/docs/api-docs.md b/docs/api-docs.md
new file mode 100644
index 0000000..e8ed8f1
--- /dev/null
+++ b/docs/api-docs.md
@@ -0,0 +1,129 @@
+# API Documentation
+
+Lorem ipsum...some description, if necessary, for the API usage section.
+
+## Table of Contents
+
+- [API Documentation](#api-documentation)
+  - [Table of Contents](#table-of-contents)
+  - [`guitar-diagrams.js` Class](#guitar-diagramsjs-class)
+    - [`guitar-diagrams.js` Constructors (non-default)](#guitar-diagramsjs-constructors-non-default)
+    - [`guitar-diagrams.js` Static Public Members](#guitar-diagramsjs-static-public-members)
+    - [`guitar-diagrams.js` Public Properties](#guitar-diagramsjs-public-properties)
+    - [`guitar-diagrams.js` Public Methods](#guitar-diagramsjs-public-methods)
+  - [`guitar-diagrams-config.js` Class](#guitar-diagrams-configjs-class)
+    - [`guitar-diagrams-config.js` Constructors (non-default)](#guitar-diagrams-configjs-constructors-non-default)
+    - [`guitar-diagrams-config.js` Public Properties](#guitar-diagrams-configjs-public-properties)
+      - [canvasID (get)](#canvasid-get)
+      - [canvasID (set)](#canvasid-set)
+      - [colorFretboard (get)](#colorfretboard-get)
+      - [colorFretboard (set)](#colorfretboard-set)
+    - [`guitar-diagrams-config.js` Public Methods](#guitar-diagrams-configjs-public-methods)
+  - [`guitar-diagrams-marker.js` Class](#guitar-diagrams-markerjs-class)
+    - [`guitar-diagrams-marker.js` Constructors (non-default)](#guitar-diagrams-markerjs-constructors-non-default)
+    - [`guitar-diagrams-marker.js` Public Properties](#guitar-diagrams-markerjs-public-properties)
+    - [`guitar-diagrams-marker.js` Public Methods](#guitar-diagrams-markerjs-public-methods)
+
+---
+
+## <a name="guitar-diagrams.js"></a>`guitar-diagrams.js` Class
+
+### <a name="guitar-diagrams.js-constructor"></a>`guitar-diagrams.js` Constructors (non-default)
+
+Constructor(s) in `guitar-diagrams.js` go here... or _None._
+
+### <a name="guitar-diagrams.js-static-public-members"></a>`guitar-diagrams.js` Static Public Members
+
+Static members in `guitar-diagrams.js` go here... (We might need to talk about how to handled these.)
+
+### <a name="guitar-diagrams.js-public-properties"></a>`guitar-diagrams.js` Public Properties
+
+Properties in `guitar-diagrams.js` go here...
+
+### <a name="guitar-diagrams.js-public-methods"></a>`guitar-diagrams.js` Public Methods
+
+Methods in `guitar-diagrams.js` go here...
+
+## <a name="guitar-diagrams-config.js"></a>`guitar-diagrams-config.js` Class
+
+### <a name="guitar-diagrams.js-constructors"></a>`guitar-diagrams-config.js` Constructors (non-default)
+
+Constructor(s) in `guitar-diagrams-config.js` go here...
+
+### <a name="guitar-diagrams.js-public-properties"></a>`guitar-diagrams-config.js` Public Properties
+
+Properties in `guitar-diagrams-config.js` go here...
+
+#### canvasID (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the ID attribute of the canvas HTML element.
+
+- **Parameters**: _None_
+- **Return Value**: {string} The ID attribute of the canvas HTML element.
+- **Default Value**: {string} 'gdjCanvas'
+
+_Example:_
+
+```javascript
+console.log('Canvas ID: ' + gdj1.config.canvasID);
+```
+
+#### canvasID (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the ID attribute of the canvas HTML element.
+
+- **Parameters**: {string} The ID attribute of the canvas HTML element.
+- **Return Value**: _None_
+- **Default Value**: {string} 'gdjCanvas'
+
+_Example:_
+
+```javascript
+gdj1.config.canvasID = 'diagram-1-canvas';
+```
+
+#### colorFretboard (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the HTML color code of the fretboard.
+
+- **Parameters**: _None_
+- **Return Value**: {string} The HTML color code of the fretboard.
+- **Default Value**: {string} '#795548'
+
+_Example:_
+
+```javascript
+console.log('Fretboard color: ' + gdj5.config.colorFretboard);
+```
+
+#### colorFretboard (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the HTML color code of the fretboard.
+
+- **Parameters**: {string} The HTML color code of the fretboard.
+- **Return Value**: _None_
+- **Default Value**: {string} '#795548'
+
+_Example:_
+
+```javascript
+gdj5.config.colorFretboard = '#FFE0B2';
+```
+
+### <a name="guitar-diagrams.js-public-methods"></a>`guitar-diagrams-config.js` Public Methods
+
+_None._
+
+## <a name="guitar-diagrams-marker.js"></a>`guitar-diagrams-marker.js` Class
+
+### <a name="guitar-diagrams-marker.js-contstructors"></a>`guitar-diagrams-marker.js` Constructors (non-default)
+
+Constructor(s) in `guitar-diagram-marker.js` go here... (There's only a default constructor as of now.)
+
+### <a name="guitar-diagrams-marker.js-public-properties">`guitar-diagrams-marker.js` Public Properties
+
+Properties in `guitar-diagrams-marker.js` go here...
+
+### <a name="guitar-diagrams-marker.js-public-methods">`guitar-diagrams-marker.js` Public Methods
+
+Methods in `guitar-diagrams-marker.js` go here...
diff --git a/docs/index.md b/docs/index.md
index 74e57c9..5ad2b5b 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -20,134 +20,4 @@ Lorem ipsum...
 
 ## API Usage
 
-Lorem ipsum...some description, if necessary, for the API usage section.
-
-### Table of Contents
-
-- [Guitar Diagrams JS Documentation](#guitar-diagrams-js-documentation)
-  - [Overview](#overview)
-  - [Getting started](#getting-started)
-    - [Importing the library into your project](#importing-the-library-into-your-project)
-    - [Initializing a diagram](#initializing-a-diagram)
-    - [Creating a diagram with markers](#creating-a-diagram-with-markers)
-  - [API Usage](#api-usage)
-    - [Table of Contents](#table-of-contents)
-    - [`guitar-diagrams.js` Class](#guitar-diagramsjs-class)
-      - [`guitar-diagrams.js` Constructors (non-default)](#guitar-diagramsjs-constructors-non-default)
-      - [`guitar-diagrams.js` Static Public Members](#guitar-diagramsjs-static-public-members)
-      - [`guitar-diagrams.js` Public Properties](#guitar-diagramsjs-public-properties)
-      - [`guitar-diagrams.js` Public Methods](#guitar-diagramsjs-public-methods)
-    - [`guitar-diagrams-config.js` Class](#guitar-diagrams-configjs-class)
-      - [`guitar-diagrams-config.js` Constructors (non-default)](#guitar-diagrams-configjs-constructors-non-default)
-      - [`guitar-diagrams-config.js` Public Properties](#guitar-diagrams-configjs-public-properties)
-        - [canvasID (get)](#canvasid-get)
-        - [canvasID (set)](#canvasid-set)
-        - [colorFretboard (get)](#colorfretboard-get)
-        - [colorFretboard (set)](#colorfretboard-set)
-      - [`guitar-diagrams-config.js` Public Methods](#guitar-diagrams-configjs-public-methods)
-    - [`guitar-diagrams-marker.js` Class](#guitar-diagrams-markerjs-class)
-      - [`guitar-diagrams-marker.js` Constructors (non-default)](#guitar-diagrams-markerjs-constructors-non-default)
-      - [`guitar-diagrams-marker.js` Public Properties](#guitar-diagrams-markerjs-public-properties)
-      - [`guitar-diagrams-marker.js` Public Methods](#guitar-diagrams-markerjs-public-methods)
-
-### <a name="guitar-diagrams.js"></a>`guitar-diagrams.js` Class
-
-#### <a name="guitar-diagrams.js-constructor"></a>`guitar-diagrams.js` Constructors (non-default)
-
-Constructor(s) in `guitar-diagrams.js` go here... or _None._
-
-#### <a name="guitar-diagrams.js-static-public-members"></a>`guitar-diagrams.js` Static Public Members
-
-Static members in `guitar-diagrams.js` go here... (We might need to talk about how to handled these.)
-
-#### <a name="guitar-diagrams.js-public-properties"></a>`guitar-diagrams.js` Public Properties
-
-Properties in `guitar-diagrams.js` go here...
-
-#### <a name="guitar-diagrams.js-public-methods"></a>`guitar-diagrams.js` Public Methods
-
-Methods in `guitar-diagrams.js` go here...
-
-### <a name="guitar-diagrams-config.js"></a>`guitar-diagrams-config.js` Class
-
-#### <a name="guitar-diagrams.js-constructors"></a>`guitar-diagrams-config.js` Constructors (non-default)
-
-Constructor(s) in `guitar-diagrams-config.js` go here...
-
-#### <a name="guitar-diagrams.js-public-properties"></a>`guitar-diagrams-config.js` Public Properties
-
-Properties in `guitar-diagrams-config.js` go here...
-
-##### canvasID (get)
-
-Exists as a property of the config property on the GuitarDiagrams object. Sets the ID attribute of the canvas HTML element.
-
-- **Parameters**: _None_
-- **Return Value**: {string} The ID attribute of the canvas HTML element.
-- **Default Value**: {string} 'gdjCanvas'
-
-_Example:_
-
-```javascript
-console.log('Canvas ID: ' + gdj1.config.canvasID);
-```
-
-##### canvasID (set)
-
-Exists as a property of the config property on the GuitarDiagrams object. Gets the ID attribute of the canvas HTML element.
-
-- **Parameters**: {string} The ID attribute of the canvas HTML element.
-- **Return Value**: _None_
-- **Default Value**: {string} 'gdjCanvas'
-
-_Example:_
-
-```javascript
-gdj1.config.canvasID = 'diagram-1-canvas';
-```
-
-##### colorFretboard (get)
-
-Exists as a property of the config property on the GuitarDiagrams object. Gets the HTML color code of the fretboard.
-
-- **Parameters**: _None_
-- **Return Value**: {string} The HTML color code of the fretboard.
-- **Default Value**: {string} '#795548'
-
-_Example:_
-
-```javascript
-console.log('Fretboard color: ' + gdj5.config.colorFretboard);
-```
-
-##### colorFretboard (set)
-
-Exists as a property of the config property on the GuitarDiagrams object. Sets the HTML color code of the fretboard.
-
-- **Parameters**: {string} The HTML color code of the fretboard.
-- **Return Value**: _None_
-- **Default Value**: {string} '#795548'
-
-_Example:_
-
-```javascript
-gdj5.config.colorFretboard = '#FFE0B2';
-```
-
-#### <a name="guitar-diagrams.js-public-methods"></a>`guitar-diagrams-config.js` Public Methods
-
-_None._
-
-### <a name="guitar-diagrams-marker.js"></a>`guitar-diagrams-marker.js` Class
-
-#### <a name="guitar-diagrams-marker.js-contstructors"></a>`guitar-diagrams-marker.js` Constructors (non-default)
-
-Constructor(s) in `guitar-diagram-marker.js` go here... (There's only a default constructor as of now.)
-
-#### <a name="guitar-diagrams-marker.js-public-properties">`guitar-diagrams-marker.js` Public Properties
-
-Properties in `guitar-diagrams-marker.js` go here...
-
-#### <a name="guitar-diagrams-marker.js-public-methods">`guitar-diagrams-marker.js` Public Methods
-
-Methods in `guitar-diagrams-marker.js` go here...
+See the [API Documentation page](api-docs.md) for more information about how to use the API, including constructors (non-default), properties, public methods, and more.

From dd66d5809879fbc1fe8224a57440b7f3830410d9 Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Mon, 3 Jun 2024 15:58:52 -0700
Subject: [PATCH 09/32] Updating README.md for split docs

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 6e362c7..f84600c 100644
--- a/README.md
+++ b/README.md
@@ -141,7 +141,7 @@ You can also install this package manually by downloading it, placing the files
 
 ### More Information
 
-For more information, please see the [`docs/index.md`](docs/index.md) and ['docs/examples/index.html`](docs/examples/index.html) pages for API documentation and examples.
+For more information, please see the [`docs/index.md`](docs/index.md) and [`docs/api-docs.md`](docs/api-docs.md) pages for general usage help and API documentation. See also the [`docs/examples/index.html`](docs/examples/index.html) page for usage examples.
 
 ## Technical Information for Code Owners
 

From 5157f92be608eefc9822cccacdb86c84f1e19d81 Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Mon, 3 Jun 2024 16:10:39 -0700
Subject: [PATCH 10/32] Updating README.md

---
 README.md | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index f84600c..be1697b 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,5 @@
 # Guitar Diagrams JS
 
-[![GitHub Release](https://img.shields.io/github/v/release/KCarlile/guitar-diagrams-js?include_prereleases&logo=github&label=Latest%20version)](https://github.com/KCarlile/guitar-diagrams-js/releases)
 [![GitHub Actions Workflow Status](https://github.com/KCarlile/guitar-diagrams-js/actions/workflows/release-package.yml/badge.svg)](https://github.com/KCarlile/guitar-diagrams-js/actions/workflows/release-package.yml)
 [![Super-Linter](https://github.com/KCarlile/guitar-diagrams-js/actions/workflows/linting.yml/badge.svg)](https://github.com/marketplace/actions/super-linter)
 
@@ -17,7 +16,7 @@
 _Guitar Diagrams JS_ is an open source JavaScript library for drawing guitar chords and scales on an HTML5 canvas.
 
 Project: <https://github.com/KCarlile/guitar-diagrams-js>\
-Version: 0.9.2
+Version: [![GitHub Release](https://img.shields.io/github/v/release/KCarlile/guitar-diagrams-js?include_prereleases&logo=github&label=Latest%20version)](https://github.com/KCarlile/guitar-diagrams-js/releases)
 
 ### Why should you use Guitar Diagrams JS?
 
@@ -27,12 +26,15 @@ The benefit of Guitar Diagrams JS is that it provides a visual representation of
 
 Here are some other comparisons to Guitar Diagrams JS:
 
-| Name | Description | Visual | Graphical | Instrument Representation | No Sheet Music | Cost |
-| ---- | ----------- | ------ | --------- | ------------------------- | -------------- | ---- |
-| Guitar Diagrams JS | Create diagrams with minimal code and no graphics | ✅ | ✅ | ✅ | ✅ | $0 |
-| Tablature (tabs) | Create diagrams manually with text | ✅ | ✅ | ⚠️ | ✅ | $0 |
-| Graphic Design Software | Create diagrams manually with a graphic design program | ✅ | ✅ | ⚠️ | ✅ | [\$22.99/month](https://www.adobe.com/products/photoshop/plans.html) |
-| Sheet Music | Create sheet music | ✅ | ❌ | ❌ | ❌ | [\$99](https://www.finalemusic.com/products/finale/special-pricing/) or [\$27.99/month](https://www.avid.com/sibelius/sibelius-ultimate-subscriptions?usertype=individual) |
+| Name | Description | Visual | Graphical | Instrument Representation | No Sheet Music Reading | Works with Musical Passages | Cost |
+| ---- | ----------- | ------ | --------- | ------------------------- | -------------- | ---------------- | ---- |
+| Guitar Diagrams JS | Create diagrams with minimal code and no graphics | ✅ | ✅ | ✅ | ✅ | ❌ | $0 |
+| Tablature (tabs) | Create diagrams manually with text | ✅ | ✅ | ⚠️ | ✅ | ✅ | $0, but time consuming and error prone |
+| Graphic Design Software | Create diagrams manually with a graphic design program | ✅ | ✅ | ⚠️ | ✅ | ❌ | [\$22.99/month](https://www.adobe.com/products/photoshop/plans.html), and very time consuming |
+| Sheet Music | Create sheet music | ✅ | ❌ | ❌ | ❌ | ✅ | [\$99](https://www.finalemusic.com/products/finale/special-pricing/) or [\$27.99/month](https://www.avid.com/sibelius/sibelius-ultimate-subscriptions?usertype=individual), and requires music notation proficiency |
+
+Key: ✅Yes. ⚠️Maybe, sorta, kinda, optional. ❌ No.
+
 
 ## Project Lead/Owner and Contributors
 
@@ -74,16 +76,16 @@ See the repository's [Releases page](https://github.com/KCarlile/guitar-diagrams
 
 For full details, see the Node JS packages released by this project here: <https://github.com/KCarlile/guitar-diagrams-js/pkgs/npm/guitar-diagrams-js>
 
-You can install Guitar Diagrams JS in your project as a Node JS dependency via NPM. Run the following command from your project's directory:
+You can install Guitar Diagrams JS in your project as a Node JS dependency via NPM. Run the following command from your project's directory where `x.y.z` (e.g., `1.0.2`) is the version (or branch name, such as `main`) of the library you want to use:
 
 ```bash
-npm install @kcarlile/guitar-diagrams-js@0.9.2
+npm install @kcarlile/guitar-diagrams-js@x.y.z
 ```
 
 Or, alternately, you can manually edit your `package.json` file and add the following entry:
 
 ```json
-"@kcarlile/guitar-diagrams-js": "0.9.2",
+"@kcarlile/guitar-diagrams-js": "x.y.z",
 ```
 
 #### Option 2: Manual Installation via CDN

From c3a6fa8f4d2ab04355d33c871ec09ee4380c799d Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Mon, 3 Jun 2024 17:29:12 -0700
Subject: [PATCH 11/32] Updating usage documentation

---
 README.md     |  74 ++-----------------------
 docs/index.md | 147 ++++++++++++++++++++++++++++++++++++++++++++++----
 2 files changed, 140 insertions(+), 81 deletions(-)

diff --git a/README.md b/README.md
index be1697b..019a1cc 100644
--- a/README.md
+++ b/README.md
@@ -35,7 +35,6 @@ Here are some other comparisons to Guitar Diagrams JS:
 
 Key: ✅Yes. ⚠️Maybe, sorta, kinda, optional. ❌ No.
 
-
 ## Project Lead/Owner and Contributors
 
 ### Project Lead/Owner
@@ -56,6 +55,8 @@ GitHub profile: [@KCarlile](https://github.com/KCarlile)
 Please see the following pages for more information:
 
 - [`README.md`](README.md): this page
+- [`docs/index.md`](docs/index.md): general usage documentation
+- [`docs/api-docs.md`](docs/api-docs.md): API usage documentation
 - [`docs/index.md`](docs/index.md): main landing page for project documentation
 - [`docs/api-docs.md`](docs/api-docs.md): API usage documentation
 - [`docs/code-owner-docs.md`](docs/code-owner-docs.md): technical documentation for code owners
@@ -70,76 +71,7 @@ See the repository's [Releases page](https://github.com/KCarlile/guitar-diagrams
 
 ## Technical Information for Site Builders
 
-### Usage in Your Project
-
-#### Option 1: Installation as a Node Dependency
-
-For full details, see the Node JS packages released by this project here: <https://github.com/KCarlile/guitar-diagrams-js/pkgs/npm/guitar-diagrams-js>
-
-You can install Guitar Diagrams JS in your project as a Node JS dependency via NPM. Run the following command from your project's directory where `x.y.z` (e.g., `1.0.2`) is the version (or branch name, such as `main`) of the library you want to use:
-
-```bash
-npm install @kcarlile/guitar-diagrams-js@x.y.z
-```
-
-Or, alternately, you can manually edit your `package.json` file and add the following entry:
-
-```json
-"@kcarlile/guitar-diagrams-js": "x.y.z",
-```
-
-#### Option 2: Manual Installation via CDN
-
-If you want to use a CDN-hosted package (e.g., Guitar Diagrams JS on JSDelivr at `https://cdn.jsdelivr.net/gh/KCarlile/guitar-diagrams-js@main/guitar-diagrams.js`), you can reference it in your code like this:
-
-```html
-<div id="diagram-1"></div>
-<script type="module">
-   import { GuitarDiagramsJS } from 'https://cdn.jsdelivr.net/gh/KCarlile/guitar-diagrams-js@main/guitar-diagrams.js';
-
-   let gdj1 = new GuitarDiagramsJS();
-   gdj1.config.canvasID = 'diagram-1-canvas'; // specify the canvas element's an ID
-   gdj1.addCanvas('diagram-1'); // add the canvas to the specified element ID on the page
-   gdj1.drawNeck(); // draw the fretboard
-</script>
-```
-
-Be sure to add some target HTML element to your page with a matching ID (`gdj1.addCanvas('diagram-1');` where `diagram-1` is the ID) in your JS code so Guitar Diagrams JS knows where to add your drawing:
-
-```html
-<div id="diagram-1"></div>
-```
-
-#### Option 3: Manual Installation via Local Copies
-
-You can also install this package manually by downloading it, placing the files in the correct location, and modifying your site's code to reference the library. The following steps outline this process:
-
-1. Download the repository files from the [GitHub repository for Guitar Diagrams JS](https://github.com/KCarlile/guitar-diagrams-js).
-1. The only files about which you should be concerned are the following:
-   - `guitar-diagrams.js`: main functionality
-   - `guitar-diagrams-config.js`: config object
-   - `guitar-diagrams-marker.js`: marker object
-1. Place those files in your application at `wherever/you/put/your/js/files/guitar-diagram-js/`.
-1. In the JS file with your primary entrypoint, add an import statement:
-
-   ```javascript
-   import { GuitarDiagramsJS } from 'wherever/you/put/your/js/files/guitar-diagrams-js/guitar-diagrams.js';
-   ```
-
-1. Following that import statement, begin to reference the library:
-
-   ```javascript
-   let gdj1 = new GuitarDiagramsJS();
-   gdj1.config.canvasID = 'diagram-1-canvas'; // specify the canvas element's an ID
-   gdj1.addCanvas('diagram-1'); // add the canvas to the specified element ID on the page
-   gdj1.drawNeck(); // draw the fretboard
-   ```
-
-1. Be sure to add some target HTML element to your page with a matching ID (`gdj1.addCanvas('diagram-1');` where `diagram-1` is the ID) in your JS code so Guitar Diagrams JS knows where to add your drawing:
-
-   ```html
-   <div id="diagram-1"></div>
-   ```
+You can find the full usage documentation at [`docs/index.md`](docs/index.md) and the API documentation at [`docs/api-docs.md`](docs/api-docs.md). The following information is just a high-level overview of how to use Guitar Diagrams JS.
 
 ### More Information
 
diff --git a/docs/index.md b/docs/index.md
index 5ad2b5b..0f552b6 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,23 +1,150 @@
 # Guitar Diagrams JS Documentation
 
-## Overview
+## Getting Started with Guitar Diagrams JS
 
-Lorem ipsum...
+### Importing the Library into Your Project
 
-## Getting started
+There are three primary ways to include the Guitar Diagrams JS library into your project:
 
-### Importing the library into your project
+1. Install the Guitar Diagrams JS library as a Node JS dependency
+1. Reference the Guitar Diagrams JS library from a hosted CDN provider
+1. Reference the Guitar Diagrams JS library from a local copy of the JavaScript (JS) files
 
-Lorem ipsum...
+#### Option 1: Installation as a Node JS Dependency
 
-### Initializing a diagram
+For full details, see the Node JS packages released by this project here: <https://github.com/KCarlile/guitar-diagrams-js/pkgs/npm/guitar-diagrams-js>
 
-Lorem ipsum...
+You can install Guitar Diagrams JS in your project as a Node JS dependency via NPM. Run the following command from your project's directory where `x.y.z` (e.g., `1.0.2`) is the version (or branch name, such as `main`) of the library you want to use:
 
-### Creating a diagram with markers
+```bash
+npm install @kcarlile/guitar-diagrams-js@x.y.z
+```
 
-Lorem ipsum...
+Or, alternately, you can manually edit your `package.json` file and add the following entry:
 
-## API Usage
+```json
+"@kcarlile/guitar-diagrams-js": "x.y.z",
+```
+
+#### Option 2: Manual Reference via CDN-Hosted Files
+
+If you want to use a CDN-hosted package (e.g., Guitar Diagrams JS on JSDelivr at `https://cdn.jsdelivr.net/gh/KCarlile/guitar-diagrams-js@main/guitar-diagrams.js`), you can reference it in your code like this:
+
+```html
+<script type="module">
+   import { GuitarDiagramsJS } from 'https://cdn.jsdelivr.net/gh/KCarlile/guitar-diagrams-js@main/guitar-diagrams.js';
+   // code to configure and use Guitar Diagrams JS goes here
+</script>
+```
+
+Be sure to add some target HTML element to your page with a matching ID (`gdj1.addCanvas('diagram-1');` where `diagram-1` is the ID) in your JS code so Guitar Diagrams JS knows where to add your drawing:
+
+   ```html
+   <div id="diagram-1"></div>
+   ```
+
+#### Option 3: Manual Reference via Local Copies of Files
+
+You can also install this package manually by downloading it, placing the files in the correct location, and modifying your site's code to reference the library. The following steps outline this process:
+
+1. Download the repository files from the [GitHub repository for Guitar Diagrams JS](https://github.com/KCarlile/guitar-diagrams-js).
+1. The only files about which you should be concerned are the following:
+   - `guitar-diagrams.js`: main functionality
+   - `guitar-diagrams-config.js`: config object
+   - `guitar-diagrams-marker.js`: marker object
+1. Place those files in your application at `wherever/you/put/your/js/files/guitar-diagram-js/`.
+1. In the JS file with your primary entrypoint, add an import statement:
+
+   ```javascript
+   <script type="module">
+      import { GuitarDiagramsJS } from 'wherever/you/put/your/js/files/guitar-diagrams-js/guitar-diagrams.js';
+      // code to configure and use Guitar Diagrams JS goes here
+   </script>
+   ```
+
+1. Be sure to add some target HTML element to your page with a matching ID (`gdj1.addCanvas('diagram-1');` where `diagram-1` is the ID) in your JS code so Guitar Diagrams JS knows where to add your drawing:
+
+   ```html
+   <div id="diagram-1"></div>
+   ```
+
+### Leveraging the Guitar Diagrams JS Library in Your Project
+
+Once you've successfully referenced the library using one of the methods outlined above, you'll need to prepare your HTML and JavaScript to leverage the library.
+
+#### Specifying the Location of the Diagram
+
+In your HTML markup, ensure that you have some block-level element (`<p>`, `<div>`, etc.) with a unique ID that you can reference from JavaScript, such as:
+
+```html
+<div id="diagram-1"></div>
+```
+
+Remember the unique ID of this block-level element as you'll be using it in the next section.
+
+### Initializing a Diagram
+
+After your import statement, add the JavaScript to associate your block-level element's unique ID with an instance of a Guitar Diagrams JS object, like this:
+
+```javascript
+let gdj1 = new GuitarDiagramsJS();
+gdj1.config.canvasID = 'diagram-1-canvas'; // specify the canvas element's unique ID
+gdj1.addCanvas('diagram-1'); // add the canvas to the specified element ID on the page
+gdj1.drawNeck(); // draw the fretboard
+```
+
+This will result in the most basic guitar diagram of a blank fretboard. The following explains what each line does:
+
+| Line | Code | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| 1 | `let gdj1 = new GuitarDiagramsJS();`| Instantiate a new `GuitarDiagramsJS` object and assign it to the `gdj1` variable|  |
+| 2 | `gdj1.config.canvasID = 'diagram-1-canvas';` | Set the canvasID value of the gdj1's config object to `'diagram-1-canvas'` | `'diagram-1-canvas'` is a unique ID for the `<canvas>` HTML element that will be added to your HTML within the block-level element. This ID is important so you can reference it later if you want to style the canvas itself. |
+| 3 | `gdj1.addCanvas('diagram-1');` | Add the Guitar Diagrams JS HTML `<canvas>` element to the parent block-level HTML element as specified by the element's unique ID | The ID string being passed here is the one specified in your HTML, like the example above: ```<div id="diagram-1"></div>``` |
+| 4 | `gdj1.drawNeck();` | Draw the neck of the diagram with the previously specified parameters |  |
+
+See _Example 1_ on the [Examples page](examples/index.html).
+
+### Creating a Diagram with Markers
+
+To add markers to a diagram, after calling `gdj1.drawNeck();`, you'll need to specify those markers and then draw them, like this:
+
+```javascript
+let gdj2 = new GuitarDiagramsJS();
+gdj2.config.canvasID = 'diagram-2-canvas';
+gdj2.config.stringNamesEnabled = true;
+gdj2.addCanvas('diagram-2');
+gdj2.drawNeck();
+gdj2.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square); // add a square marker on string 1, fret 1, text '1'
+gdj2.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle); // add a triangle marker on string 2, fret 2, text '2'
+gdj2.addMarker(3, 3, '3', GuitarDiagramsJS.Shape.Diamond); // add a diamond marker on string 3, fret 3, text '3'
+gdj2.addMarker(4, 4, '4'); // add a default (circle) marker on string 4, fret 4, text '4'
+gdj2.addMarker(5, 0, '0'); // add a default (circle) marker on string 5, fret 0, text '0'
+gdj2.addMarker(6, 0, 'X'); // add a default (circle) marker on string 6, fret 0, text 'X'
+gdj2.addMarker(3, 1); // add a default (circle) marker on string 3, fret 1, text empty
+gdj2.drawAllMarkers(); // draw the markers
+```
+
+This will result in a basic guitar fretboard diagram with 7 different markers added. The following explains what each line does:
+
+| Line | Code | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| 1 | `let gdj2 = new GuitarDiagramsJS();`| Instantiate a new `GuitarDiagramsJS` object and assign it to the `gdj1` variable|  |
+| 2 | `gdj2.config.canvasID = 'diagram-2-canvas';` | Set the canvasID value of the gdj1's config object to `'diagram-2-canvas'` | `'diagram-2-canvas'` is a unique ID for the `<canvas>` HTML element that will be added to your HTML within the block-level element. This ID is important so you can reference it later if you want to style the canvas itself. |
+| 3 | `gdj1.addCanvas('diagram-2');` | Add the Guitar Diagrams JS HTML `<canvas>` element to the parent block-level HTML element as specified by the element's unique ID | The ID string being passed here is the one specified in your HTML, like the example above, but with a different ID for diagram 2: ```<div id="diagram-2"></div>``` |
+| 4 | `gdj1.drawNeck();` | Draw the neck of the diagram with the previously specified parameters |  |
+| 5 | `gdj2.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square);` | Adds a marker on the string 1, fret 1, with text "1", and square shape |  |
+| 6 | `gdj2.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle);` | Adds a marker on the string 2, fret 2, with text "2", and triangle shape |  |
+| 7 | `gdj2.addMarker(3, 3, '3', GuitarDiagramsJS.Shape.Diamond);` | Adds a marker on the string 3, fret 3, with text "3", and diamond shape |  |
+| 8 | `gdj2.addMarker(4, 4, '4');` | Adds a marker on the string 4, fret 4, with text "4" | If a shape is not specified, circle is the default shape. |
+| 9 | `gdj2.addMarker(5, 0, '0');` | Adds a marker on the string 5, fret 0, with text "0" | If a shape is not specified, circle is the default shape. "0" for fret marker indicates an open string. |
+| 10 | `gdj2.addMarker(6, 0, 'X');` | Adds a marker on the string 6, fret 0, with text "X" | If a shape is not specified, circle is the default shape. "X" for fret marker indicates a muted string. |
+| 11 | `gdj2.addMarker(3, 1);` | Adds a marker on the string 3, fret 1 | If text is not specified, the marker will be blank. If a shape is not specified, circle is the default shape. |
+| 12 | `gdj2.drawAllMarkers();` | Draws all of the specified markers on the fretboard | If a specified marker would be rendered beyond the visible fretboard, it will not be rendered and an error will be logged to the console. |
+
+See _Example 2_ on the [Examples page](examples/index.html).
+
+See the full [API documentation](api-docs.md) for all of the options for markers.
+
+## API Usage Details
 
 See the [API Documentation page](api-docs.md) for more information about how to use the API, including constructors (non-default), properties, public methods, and more.

From d73d8a3895ad6681e381273ff4c772cd24d086ae Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Mon, 3 Jun 2024 17:30:31 -0700
Subject: [PATCH 12/32] Updating usage documentation

---
 docs/index.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/index.md b/docs/index.md
index 0f552b6..19eb8a4 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -37,11 +37,11 @@ If you want to use a CDN-hosted package (e.g., Guitar Diagrams JS on JSDelivr at
 </script>
 ```
 
-Be sure to add some target HTML element to your page with a matching ID (`gdj1.addCanvas('diagram-1');` where `diagram-1` is the ID) in your JS code so Guitar Diagrams JS knows where to add your drawing:
+Be sure to add some target HTML element to your page with a matching ID (`gdj1.addCanvas('diagram-1');` where `'diagram-1'` is the ID) in your JS code so Guitar Diagrams JS knows where to add your drawing:
 
-   ```html
-   <div id="diagram-1"></div>
-   ```
+```html
+<div id="diagram-1"></div>
+```
 
 #### Option 3: Manual Reference via Local Copies of Files
 
@@ -62,7 +62,7 @@ You can also install this package manually by downloading it, placing the files
    </script>
    ```
 
-1. Be sure to add some target HTML element to your page with a matching ID (`gdj1.addCanvas('diagram-1');` where `diagram-1` is the ID) in your JS code so Guitar Diagrams JS knows where to add your drawing:
+1. Be sure to add some target HTML element to your page with a matching ID (`gdj1.addCanvas('diagram-1');` where `'diagram-1'` is the ID) in your JS code so Guitar Diagrams JS knows where to add your drawing:
 
    ```html
    <div id="diagram-1"></div>

From 2d1074e59c1c6d4c3ccc4678753bec91d5f86a9c Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Mon, 3 Jun 2024 19:21:55 -0700
Subject: [PATCH 13/32] Removing code comments from docs

---
 docs/index.md | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/docs/index.md b/docs/index.md
index 19eb8a4..51abbd7 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -88,9 +88,9 @@ After your import statement, add the JavaScript to associate your block-level el
 
 ```javascript
 let gdj1 = new GuitarDiagramsJS();
-gdj1.config.canvasID = 'diagram-1-canvas'; // specify the canvas element's unique ID
-gdj1.addCanvas('diagram-1'); // add the canvas to the specified element ID on the page
-gdj1.drawNeck(); // draw the fretboard
+gdj1.config.canvasID = 'diagram-1-canvas';
+gdj1.addCanvas('diagram-1');
+gdj1.drawNeck();
 ```
 
 This will result in the most basic guitar diagram of a blank fretboard. The following explains what each line does:
@@ -114,14 +114,14 @@ gdj2.config.canvasID = 'diagram-2-canvas';
 gdj2.config.stringNamesEnabled = true;
 gdj2.addCanvas('diagram-2');
 gdj2.drawNeck();
-gdj2.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square); // add a square marker on string 1, fret 1, text '1'
-gdj2.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle); // add a triangle marker on string 2, fret 2, text '2'
-gdj2.addMarker(3, 3, '3', GuitarDiagramsJS.Shape.Diamond); // add a diamond marker on string 3, fret 3, text '3'
-gdj2.addMarker(4, 4, '4'); // add a default (circle) marker on string 4, fret 4, text '4'
-gdj2.addMarker(5, 0, '0'); // add a default (circle) marker on string 5, fret 0, text '0'
-gdj2.addMarker(6, 0, 'X'); // add a default (circle) marker on string 6, fret 0, text 'X'
-gdj2.addMarker(3, 1); // add a default (circle) marker on string 3, fret 1, text empty
-gdj2.drawAllMarkers(); // draw the markers
+gdj2.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square);
+gdj2.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle);
+gdj2.addMarker(3, 3, '3', GuitarDiagramsJS.Shape.Diamond);
+gdj2.addMarker(4, 4, '4');
+gdj2.addMarker(5, 0, '0');
+gdj2.addMarker(6, 0, 'X');
+gdj2.addMarker(3, 1);
+gdj2.drawAllMarkers();
 ```
 
 This will result in a basic guitar fretboard diagram with 7 different markers added. The following explains what each line does:

From 00c9ff3e72ba97427e58f6d4d7f048b0e2083362 Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Tue, 4 Jun 2024 19:13:10 -0700
Subject: [PATCH 14/32] Adding temporary Windows symlink for Chad

---
 .scripts/chad-win-fix.bat | 3 +++
 1 file changed, 3 insertions(+)
 create mode 100644 .scripts/chad-win-fix.bat

diff --git a/.scripts/chad-win-fix.bat b/.scripts/chad-win-fix.bat
new file mode 100644
index 0000000..b3b138c
--- /dev/null
+++ b/.scripts/chad-win-fix.bat
@@ -0,0 +1,3 @@
+mklink ..\docs\js\guitar-diagrams-js\guitar-diagrams.js ..\guitar-diagrams.js
+mklink ..\docs\js\guitar-diagrams-js\guitar-diagrams-config.js ..\guitar-diagrams-config.js
+mklink ..\docs\js\guitar-diagrams-js\guitar-diagrams-marker.js ..\guitar-diagrams-marker.js

From 3adfa3d065b8f20f2653a4451c650335f968d4fb Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Tue, 4 Jun 2024 19:16:16 -0700
Subject: [PATCH 15/32] Modifying bat file for Windows fix

---
 .scripts/chad-win-fix.bat | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.scripts/chad-win-fix.bat b/.scripts/chad-win-fix.bat
index b3b138c..a7dfeb1 100644
--- a/.scripts/chad-win-fix.bat
+++ b/.scripts/chad-win-fix.bat
@@ -1,3 +1,5 @@
+echo "Trying to fix Windows symlink issues..."
 mklink ..\docs\js\guitar-diagrams-js\guitar-diagrams.js ..\guitar-diagrams.js
 mklink ..\docs\js\guitar-diagrams-js\guitar-diagrams-config.js ..\guitar-diagrams-config.js
 mklink ..\docs\js\guitar-diagrams-js\guitar-diagrams-marker.js ..\guitar-diagrams-marker.js
+pause
\ No newline at end of file

From 9a787bc431c05cec44ccb0bf736983738143a29c Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Tue, 4 Jun 2024 19:18:44 -0700
Subject: [PATCH 16/32] Fixing paths in bat file

---
 .scripts/chad-win-fix.bat | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.scripts/chad-win-fix.bat b/.scripts/chad-win-fix.bat
index a7dfeb1..efaf010 100644
--- a/.scripts/chad-win-fix.bat
+++ b/.scripts/chad-win-fix.bat
@@ -1,5 +1,5 @@
 echo "Trying to fix Windows symlink issues..."
-mklink ..\docs\js\guitar-diagrams-js\guitar-diagrams.js ..\guitar-diagrams.js
-mklink ..\docs\js\guitar-diagrams-js\guitar-diagrams-config.js ..\guitar-diagrams-config.js
-mklink ..\docs\js\guitar-diagrams-js\guitar-diagrams-marker.js ..\guitar-diagrams-marker.js
+mklink ..\docs\examples\js\guitar-diagrams-js\guitar-diagrams.js ..\guitar-diagrams.js
+mklink ..\docs\examples\js\guitar-diagrams-js\guitar-diagrams-config.js ..\guitar-diagrams-config.js
+mklink ..\docs\examples\js\guitar-diagrams-js\guitar-diagrams-marker.js ..\guitar-diagrams-marker.js
 pause
\ No newline at end of file

From 396fcae43ef014a9d5f6abd814a24dac9aa89b36 Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Tue, 4 Jun 2024 19:20:21 -0700
Subject: [PATCH 17/32] Removing files before running win symlink fix

---
 .scripts/chad-win-fix.bat | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/.scripts/chad-win-fix.bat b/.scripts/chad-win-fix.bat
index efaf010..7a29c43 100644
--- a/.scripts/chad-win-fix.bat
+++ b/.scripts/chad-win-fix.bat
@@ -1,4 +1,9 @@
 echo "Trying to fix Windows symlink issues..."
+
+del ..\docs\examples\js\guitar-diagrams-js\guitar-diagrams.js
+del ..\docs\examples\js\guitar-diagrams-js\guitar-diagrams-config.js
+del ..\docs\examples\js\guitar-diagrams-js\guitar-diagrams-marker.js
+
 mklink ..\docs\examples\js\guitar-diagrams-js\guitar-diagrams.js ..\guitar-diagrams.js
 mklink ..\docs\examples\js\guitar-diagrams-js\guitar-diagrams-config.js ..\guitar-diagrams-config.js
 mklink ..\docs\examples\js\guitar-diagrams-js\guitar-diagrams-marker.js ..\guitar-diagrams-marker.js

From aaa8d6fb72a6b469c3197db2df744235ab155023 Mon Sep 17 00:00:00 2001
From: Chad Kreiger <ckreiger1@gmail.com>
Date: Tue, 4 Jun 2024 20:44:39 -0700
Subject: [PATCH 18/32] Updated ColorNut and ColorNutOutline

---
 docs/api-docs.md | 58 +++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 57 insertions(+), 1 deletion(-)

diff --git a/docs/api-docs.md b/docs/api-docs.md
index e8ed8f1..09c13c4 100644
--- a/docs/api-docs.md
+++ b/docs/api-docs.md
@@ -18,6 +18,10 @@ Lorem ipsum...some description, if necessary, for the API usage section.
       - [canvasID (set)](#canvasid-set)
       - [colorFretboard (get)](#colorfretboard-get)
       - [colorFretboard (set)](#colorfretboard-set)
+      - [colorNut (get)](#colornut-get)
+      - [colorNut (set)](#colornut-set)
+      - [colorNutOutline (get)](#colornutoutline-get)
+      - [colorNutOutline (set)](#colornutoutline-set)
     - [`guitar-diagrams-config.js` Public Methods](#guitar-diagrams-configjs-public-methods)
   - [`guitar-diagrams-marker.js` Class](#guitar-diagrams-markerjs-class)
     - [`guitar-diagrams-marker.js` Constructors (non-default)](#guitar-diagrams-markerjs-constructors-non-default)
@@ -70,7 +74,7 @@ console.log('Canvas ID: ' + gdj1.config.canvasID);
 
 #### canvasID (set)
 
-Exists as a property of the config property on the GuitarDiagrams object. Gets the ID attribute of the canvas HTML element.
+Exists as a property of the config property on the GuitarDiagrams object. Sets the ID attribute of the canvas HTML element.
 
 - **Parameters**: {string} The ID attribute of the canvas HTML element.
 - **Return Value**: _None_
@@ -110,6 +114,58 @@ _Example:_
 gdj5.config.colorFretboard = '#FFE0B2';
 ```
 
+#### colorNut (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the HTML color code of the nut.
+
+- **Parameters**: _None_
+- **Return Value**: {string} The HTML color code of the nut.
+- **Default Value**: {string} '#F2F3F4'
+
+_Example:_
+
+NEED EXAMPLE HERE CRK
+
+#### colorNut (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the HTML color code of the nut.
+
+- **Parameters**: {string} The HTML color code of the nut.
+- **Return Value**: _None_
+- **Default Value**: {string} '#F2F3F4'
+
+_Example:_
+
+```javascript
+gdj5.config.colorNut = '#FFFFFF';
+```
+
+#### colorNutOutline (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the HTML color code of the nut outline.
+
+- **Parameters**: {string} The HTML color code of the nut outline.
+- **Return Value**: _None_
+- **Default Value**: {string} '#000000'
+
+_Example:_
+
+NEED EXAMPLE HERE CRK
+
+#### colorNutOutline (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the HTML color code of the nut outline.
+
+- **Parameters**: {string} The HTML color code of the nut outline.
+- **Return Value**: _None_
+- **Default Value**: {string} '#000000'
+
+_Example:_
+
+```javascript
+gdj5.config.colorNutOutline = '#7E5109';
+```
+
 ### <a name="guitar-diagrams.js-public-methods"></a>`guitar-diagrams-config.js` Public Methods
 
 _None._

From a663477ab16532f6abb86026213f4b2bdf95c667 Mon Sep 17 00:00:00 2001
From: Chad Kreiger <ckreiger1@gmail.com>
Date: Tue, 4 Jun 2024 20:47:04 -0700
Subject: [PATCH 19/32] Small edits chaging Gets to Sets

---
 .../examples/js/guitar-diagrams-js/guitar-diagrams-config.mjs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/examples/js/guitar-diagrams-js/guitar-diagrams-config.mjs b/docs/examples/js/guitar-diagrams-js/guitar-diagrams-config.mjs
index f04f4e8..3b04fd0 100644
--- a/docs/examples/js/guitar-diagrams-js/guitar-diagrams-config.mjs
+++ b/docs/examples/js/guitar-diagrams-js/guitar-diagrams-config.mjs
@@ -104,7 +104,7 @@ export class GuitarDiagramsJSConfig {
     } // end get colorNut property
 
     /**
-     * Gets the HTML color code of the nut.
+     * Sets the HTML color code of the nut.
      * @param {string} paramColorNut - The HTML color code of the nut.
      */
     set colorNut(paramColorNut) {
@@ -120,7 +120,7 @@ export class GuitarDiagramsJSConfig {
     } // end get colorNutOutline property
 
     /**
-     * Gets the HTML color code of the nut outline.
+     * Sets the HTML color code of the nut outline.
      * @param {string} paramColorNutOutline - The HTML color code of the nut outline.
      */
     set colorNutOutline(paramColorNutOutline) {

From dc12a499daf4ca1b6961abff68811e66b1659b2a Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Tue, 4 Jun 2024 21:03:49 -0700
Subject: [PATCH 20/32] Removing chad-win-fix.bat script, abandoning this
 attempt

---
 .scripts/chad-win-fix.bat | 10 ----------
 1 file changed, 10 deletions(-)
 delete mode 100644 .scripts/chad-win-fix.bat

diff --git a/.scripts/chad-win-fix.bat b/.scripts/chad-win-fix.bat
deleted file mode 100644
index 7a29c43..0000000
--- a/.scripts/chad-win-fix.bat
+++ /dev/null
@@ -1,10 +0,0 @@
-echo "Trying to fix Windows symlink issues..."
-
-del ..\docs\examples\js\guitar-diagrams-js\guitar-diagrams.js
-del ..\docs\examples\js\guitar-diagrams-js\guitar-diagrams-config.js
-del ..\docs\examples\js\guitar-diagrams-js\guitar-diagrams-marker.js
-
-mklink ..\docs\examples\js\guitar-diagrams-js\guitar-diagrams.js ..\guitar-diagrams.js
-mklink ..\docs\examples\js\guitar-diagrams-js\guitar-diagrams-config.js ..\guitar-diagrams-config.js
-mklink ..\docs\examples\js\guitar-diagrams-js\guitar-diagrams-marker.js ..\guitar-diagrams-marker.js
-pause
\ No newline at end of file

From f74e9e0afff8c16e60b278ca1afa4d6a75709c8b Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Tue, 4 Jun 2024 21:07:29 -0700
Subject: [PATCH 21/32] Adding JS examples

---
 docs/api-docs.md | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/docs/api-docs.md b/docs/api-docs.md
index 09c13c4..94a30ba 100644
--- a/docs/api-docs.md
+++ b/docs/api-docs.md
@@ -111,7 +111,7 @@ Exists as a property of the config property on the GuitarDiagrams object. Sets t
 _Example:_
 
 ```javascript
-gdj5.config.colorFretboard = '#FFE0B2';
+gdj1.config.colorFretboard = '#FFE0B2';
 ```
 
 #### colorNut (get)
@@ -124,7 +124,9 @@ Exists as a property of the config property on the GuitarDiagrams object. Gets t
 
 _Example:_
 
-NEED EXAMPLE HERE CRK
+```javascript
+console.log(gdj1.config.colorNut);
+```
 
 #### colorNut (set)
 
@@ -137,7 +139,7 @@ Exists as a property of the config property on the GuitarDiagrams object. Sets t
 _Example:_
 
 ```javascript
-gdj5.config.colorNut = '#FFFFFF';
+gdj1.config.colorNut = '#FFFFFF';
 ```
 
 #### colorNutOutline (get)
@@ -150,7 +152,9 @@ Exists as a property of the config property on the GuitarDiagrams object. Gets t
 
 _Example:_
 
-NEED EXAMPLE HERE CRK
+```javascript
+console.log(gdj1.config.colorNutOutline);
+```
 
 #### colorNutOutline (set)
 
@@ -163,7 +167,7 @@ Exists as a property of the config property on the GuitarDiagrams object. Sets t
 _Example:_
 
 ```javascript
-gdj5.config.colorNutOutline = '#7E5109';
+gdj1.config.colorNutOutline = '#7E5109';
 ```
 
 ### <a name="guitar-diagrams.js-public-methods"></a>`guitar-diagrams-config.js` Public Methods

From 83b2a2e788b91940b692d8a331b9645fff77e5ed Mon Sep 17 00:00:00 2001
From: Chad Kreiger <ckreiger1@gmail.com>
Date: Wed, 5 Jun 2024 22:18:37 -0700
Subject: [PATCH 22/32] More get and set properties added to api-docs.md

---
 docs/api-docs.md | 154 ++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 152 insertions(+), 2 deletions(-)

diff --git a/docs/api-docs.md b/docs/api-docs.md
index 94a30ba..7f57ecf 100644
--- a/docs/api-docs.md
+++ b/docs/api-docs.md
@@ -22,6 +22,16 @@ Lorem ipsum...some description, if necessary, for the API usage section.
       - [colorNut (set)](#colornut-set)
       - [colorNutOutline (get)](#colornutoutline-get)
       - [colorNutOutline (set)](#colornutoutline-set)
+      - [colorFrets (get)](#colorfrets-get)
+      - [colorFrets (set)](#colorfrets-set)
+      - [colorStrings (get)](#colorstrings-get)
+      - [colorStrings (set)](#colorstrings-set)
+      - [colorFretMarker (get)](#colorfretmarker-get)
+      - [colorFretMarker (set)](#colorfretmarker-set)
+      - [colorDiagramBackground (get)](#colordiagrambackground-get)
+      - [colorDiagramBackground (set)](#colordiagrambackground-set)
+      - [colorLabel (get)](#colorlabel-get)
+      - [colorLabel (set)](#colorlabel-set)
     - [`guitar-diagrams-config.js` Public Methods](#guitar-diagrams-configjs-public-methods)
   - [`guitar-diagrams-marker.js` Class](#guitar-diagrams-markerjs-class)
     - [`guitar-diagrams-marker.js` Constructors (non-default)](#guitar-diagrams-markerjs-constructors-non-default)
@@ -146,8 +156,8 @@ gdj1.config.colorNut = '#FFFFFF';
 
 Exists as a property of the config property on the GuitarDiagrams object. Gets the HTML color code of the nut outline.
 
-- **Parameters**: {string} The HTML color code of the nut outline.
-- **Return Value**: _None_
+- **Parameters**: _None_ 
+- **Return Value**: {string} The HTML color code of the nut outline.
 - **Default Value**: {string} '#000000'
 
 _Example:_
@@ -170,6 +180,146 @@ _Example:_
 gdj1.config.colorNutOutline = '#7E5109';
 ```
 
+#### colorFrets (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the HTML color code of the frets.
+
+- **Parameters**: _None_
+- **Return Value**: {string} The HTML color code of the frets.
+- **Default Value**: {string} '#808B96'
+
+_Example:_
+
+```javascript
+console.log(gdj1.config.colorFrets);
+```
+
+#### colorFrets (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the HTML color code of the frets.
+
+- **Parameters**: {string} The HTML color code of the nut outline.
+- **Return Value**: _None_
+- **Default Value**: {string} '#808B96'
+
+_Example:_
+
+```javascript
+gdj1.config.colorFrets = '#AEB6BF';
+```
+
+#### colorStrings (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the HTML color code of the strings.
+
+- **Parameters**: _None_
+- **Return Value**: {string} The HTML color code of the strings.
+- **Default Value**: {string} '#CFD8DC'
+
+_Example:_
+
+```javascript
+console.log(gdj1.config.colorStrings);
+```
+
+#### colorStrings (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the HTML color code of the strings.
+
+- **Parameters**: {string} The HTML color code of the strings.
+- **Return Value**: _None_
+- **Default Value**: {string} '#CFD8DC'
+
+_Example:_
+
+```javascript
+gdj1.config.colorStrings = '#566573';
+```
+
+#### colorFretMarker (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the HTML color code of the fret markers.
+
+- **Parameters**: _None_
+- **Return Value**: {string} The HTML color code of the fret markers.
+- **Default Value**: {string} '#FFFFFF'
+
+_Example:_
+
+```javascript
+console.log(gdj1.config.colorFretMarker);
+```
+
+#### colorFretMarker (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the HTML color code of the fret markers.
+
+- **Parameters**: {string} The HTML color code of the fret markers.
+- **Return Value**: _None_
+- **Default Value**: {string} '#FFFFFF'
+
+_Example:_
+
+```javascript
+gdj1.config.colorFretMarker = '#424949';
+```
+
+#### colorDiagramBackground (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the HTML color code of the diagram background. 
+
+- **Parameters**: _None_
+- **Return Value**: {string} The HTML color code of the diagram background.
+- **Default Value**: {string} null
+
+_Example:_
+
+```javascript
+console.log(gdj1.config.colorDiagramBackground);
+```
+
+#### colorDiagramBackground (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the HTML color code of the diagram background. 
+
+- **Parameters**: {string} The HTML color code of the diagram background.
+- **Return Value**: _None_
+- **Default Value**: {string} null
+
+_Example:_
+
+```javascript
+gdj1.config.colorDiagramBackground = '#000000';
+```
+
+#### colorLabel (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets HTML color code of the label text for string names and fret number.
+
+- **Parameters**: _None_
+- **Return Value**: {string} The HTML color code of the label text for string names and fret number.
+- **Default Value**: {string} '#000000'
+
+_Example:_
+
+```javascript
+console.log(gdj1.config.colorLabel);
+```
+
+#### colorLabel (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets HTML color code of the label text for string names and fret number.
+
+- **Parameters**: {string} The HTML color code of the label text for string names and fret number.
+- **Return Value**: _None_
+- **Default Value**: {string} '#FFFFFF'
+
+_Example:_
+
+```javascript
+gdj1.config.colorDiagramBackground = '#000000';
+```
+
 ### <a name="guitar-diagrams.js-public-methods"></a>`guitar-diagrams-config.js` Public Methods
 
 _None._

From eb6423c32c99a15d55c86572de55873a99fa5d69 Mon Sep 17 00:00:00 2001
From: Chad Kreiger <ckreiger1@gmail.com>
Date: Fri, 7 Jun 2024 20:10:30 -0700
Subject: [PATCH 23/32] Finished adding the property entries for the config.js
 file

---
 docs/api-docs.md | 301 ++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 299 insertions(+), 2 deletions(-)

diff --git a/docs/api-docs.md b/docs/api-docs.md
index 7f57ecf..5d01d28 100644
--- a/docs/api-docs.md
+++ b/docs/api-docs.md
@@ -32,6 +32,26 @@ Lorem ipsum...some description, if necessary, for the API usage section.
       - [colorDiagramBackground (set)](#colordiagrambackground-set)
       - [colorLabel (get)](#colorlabel-get)
       - [colorLabel (set)](#colorlabel-set)
+      - [markerStrokeWidth (get)](#markerstrokewidth-get)
+      - [markerStrokeWidth (set)](#markerstrokewidth-set)
+      - [markerFontSize (get)](#markerfontsize-get)
+      - [markerFontSize (set)](#markerfontsize-set)
+      - [fretCount (get)](#fretcount-get)
+      - [fretCount (set)](#fretcount-set)
+      - [scaleFactor (get)](#scalefactor-get)
+      - [scaleFactor (set)](#scalefactor-set)
+      - [orientHorizontally (get)](#orienthorizontally-get)
+      - [orientHorizontally (set)](#orienthorizontally-set)
+      - [fretMarkerEnabled (get)](#fretmarkerenabled-get)
+      - [fretMarkerEnabled (set)](#fretmarkerenabled-set)
+      - [fretStartingNumber (get)](#fretstartingnumber-get)
+      - [fretStartingNumber (set)](#fretstartingnumber-set)
+      - [stringNamesEnabled (get)](#stringnamesenabled-get)
+      - [stringNamesEnabled (set)](#stringnamesenabled-set)
+      - [stringNames (get)](#stringnames-get)
+      - [stringNames (set)](#stringnames-set)
+      - [downloadImageEnabled (get)](#downloadimageenabled-get)
+      - [downloadImageEnabled (set)](#downloadimageenabled-set)
     - [`guitar-diagrams-config.js` Public Methods](#guitar-diagrams-configjs-public-methods)
   - [`guitar-diagrams-marker.js` Class](#guitar-diagrams-markerjs-class)
     - [`guitar-diagrams-marker.js` Constructors (non-default)](#guitar-diagrams-markerjs-constructors-non-default)
@@ -312,14 +332,291 @@ Exists as a property of the config property on the GuitarDiagrams object. Sets H
 
 - **Parameters**: {string} The HTML color code of the label text for string names and fret number.
 - **Return Value**: _None_
-- **Default Value**: {string} '#FFFFFF'
+- **Default Value**: {string} '#000000'
 
 _Example:_
 
 ```javascript
-gdj1.config.colorDiagramBackground = '#000000';
+gdj1.config.colorLabel = '#000000';
+```
+
+#### markerStrokeWidth (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the marker's stroke width.
+
+- **Parameters**: _None_
+- **Return Value**: {number} The marker's stroke width.
+- **Default Value**: {number} 2
+
+_Example:_
+
+```javascript
+console.log(gdj1.markerStrokeWidth);
+```
+
+#### markerStrokeWidth (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the marker's stroke width.
+
+- **Parameters**: {number} The marker's stroke width.
+- **Return Value**: _None_
+- **Default Value**: {number} 2
+
+_Example:_
+
+```javascript
+gdj1.config.markerStrokeWidth = 1;
+```
+#### markerFontSize (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the marker's font size.
+
+- **Parameters**: _None_
+- **Return Value**: {number} The marker's font size.
+- **Default Value**: {number} 16
+
+_Example:_
+
+```javascript
+console.log(gdj1.config.markerFontSize);
+```
+
+#### markerFontSize (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the marker's font size.
+
+- **Parameters**: {number} The marker's font size.
+- **Return Value**: _None_
+- **Default Value**: {number} 16
+
+_Example:_
+
+```javascript
+gdj1.config.markerFontSize = 10;
+```
+#### fretCount (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the number of frets on the diagram.
+
+- **Parameters**: _None_
+- **Return Value**: {number} The number of frets on the diagram.
+- **Default Value**: {number} 5
+
+_Example:_
+
+```javascript
+console.log(gdj1.config.fretCount);
+```
+
+#### fretCount (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the number of frets on the diagram.
+
+- **Parameters**: {number} The number of frets on the diagram.
+- **Return Value**: _None_
+- **Default Value**: {number} 5
+
+_Example:_
+
+```javascript
+gdj1.config.fretCount = 3;
+```
+
+#### scaleFactor (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the scale factor of the diagram.
+
+- **Parameters**: _None_
+- **Return Value**: {number} The scale factor of the diagram.
+- **Default Value**: {number} 1
+
+_Example:_
+
+```javascript
+console.log(gdj1.config.scaleFactor);
+```
+
+#### scaleFactor (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the scale factor of the diagram.
+
+- **Parameters**: {number} The scale factor of the diagram.
+- **Return Value**: _None_
+- **Default Value**: {number} 1
+
+_Example:_
+
+```javascript
+gdj1.config.scaleFactor = .6;
+```
+
+#### orientHorizontally (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the horizontal status of the diagram.
+
+- **Parameters**: _None_
+- **Return Value**: {boolean} The horizontal status of diagram.
+- **Default Value**: {boolean} false;
+
+_Example:_
+
+```javascript
+console.log(gdj1.config.orientHorizontally);
+```
+
+#### orientHorizontally (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the horizontal status of the diagram.
+
+- **Parameters**: {boolean} The horizontal status of diagram.
+- **Return Value**: _None_
+- **Default Value**: {boolean} false;
+
+_Example:_
+
+```javascript
+gdj1.config.orientHorizontally = true;
+```
+
+#### fretMarkerEnabled (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the enabled status of fret markers.
+
+- **Parameters**: _None_
+- **Return Value**: {boolean} The enabled status of fret markers.
+- **Default Value**: {boolean} true;
+
+_Example:_
+
+```javascript
+console.log(gdj1.config.fretMarkerEnabled);
+```
+
+#### fretMarkerEnabled (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the enabled status of fret markers.
+
+- **Parameters**: {boolean} The enabled status of fret markers.
+- **Return Value**: _None_
+- **Default Value**: {boolean} true;
+
+_Example:_
+
+```javascript
+gdj1.config.fretMarkerEnabled = true;
+```
+
+#### fretStartingNumber (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the starting fret number.
+
+- **Parameters**: _None_
+- **Return Value**: {number} The starting fret number.
+- **Default Value**: {number} 0;
+
+_Example:_
+
+```javascript
+console.log(gdj1.config.fretStartingNumber);
+```
+
+#### fretStartingNumber (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the starting fret number.
+
+- **Parameters**: {number} The starting fret number.
+- **Return Value**: _None_
+- **Default Value**: {number} 0;
+
+_Example:_
+
+```javascript
+gdj1.config.fretStartingNumber = 3;
+```
+
+#### stringNamesEnabled (get)
+
+Exists as a property of the config property on the GuitarDiagrams object.  Gets the enabled status of string names.
+
+- **Parameters**: _None_
+- **Return Value**: {boolean} The enabled status of string names.
+- **Default Value**: {boolean} false;
+
+_Example:_
+
+```javascript
+console.log(gdj1.config.stringNamesEnabled);
+```
+
+#### stringNamesEnabled (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the enabled status of string names.
+
+- **Parameters**: {boolean} The enabled status of string names.
+- **Return Value**: _None_
+- **Default Value**: {boolean} false;
+
+_Example:_
+
+```javascript
+gdj1.config.stringNamesEnabled = true;
 ```
 
+#### stringNames (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the array of string names.
+
+- **Parameters**: _None_
+- **Return Value**: {array} The array of string names.
+- **Default Value**: {array} ['E','A','D','G','B','e'];
+
+_Example:_
+
+```javascript
+console.log(gdj1.config.stringNames);
+```
+
+#### stringNames (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the array of string names.
+
+- **Parameters**: {array} The array of string names.
+- **Return Value**: _None_
+- **Default Value**: {array} ['E','A','D','G','B','e'];
+
+_Example:_
+
+```javascript
+gdj1.config.stringNames = ['D','A','D','G'];
+```
+
+#### downloadImageEnabled (get)
+
+Exists as a property of the config property on the GuitarDiagrams object. Gets the enabled status of the download image button.
+
+- **Parameters**: _None_
+- **Return Value**: {boolean} The enabled status of the download image button.
+- **Default Value**: {boolean} false;
+
+_Example:_
+
+```javascript
+console.log(gdj1.config.downloadImageEnabled);
+```
+
+#### downloadImageEnabled (set)
+
+Exists as a property of the config property on the GuitarDiagrams object. Sets the enabled status of the download image button.
+
+- **Parameters**: {boolean} The enabled status of the download image button.
+- **Return Value**: _None_
+- **Default Value**: {boolean} false;
+
+_Example:_
+
+```javascript
+gdj1.config.downloadImageEnabled = true;
+```
 ### <a name="guitar-diagrams.js-public-methods"></a>`guitar-diagrams-config.js` Public Methods
 
 _None._

From 457926fa46b25e755e08a076ddba6f73c8ba0ff5 Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Tue, 11 Jun 2024 12:05:37 -0700
Subject: [PATCH 24/32] Fixing markdown syntax issues

---
 docs/api-docs.md | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/docs/api-docs.md b/docs/api-docs.md
index 5d01d28..b99c021 100644
--- a/docs/api-docs.md
+++ b/docs/api-docs.md
@@ -176,7 +176,7 @@ gdj1.config.colorNut = '#FFFFFF';
 
 Exists as a property of the config property on the GuitarDiagrams object. Gets the HTML color code of the nut outline.
 
-- **Parameters**: _None_ 
+- **Parameters**: _None_
 - **Return Value**: {string} The HTML color code of the nut outline.
 - **Default Value**: {string} '#000000'
 
@@ -286,7 +286,7 @@ gdj1.config.colorFretMarker = '#424949';
 
 #### colorDiagramBackground (get)
 
-Exists as a property of the config property on the GuitarDiagrams object. Gets the HTML color code of the diagram background. 
+Exists as a property of the config property on the GuitarDiagrams object. Gets the HTML color code of the diagram background.
 
 - **Parameters**: _None_
 - **Return Value**: {string} The HTML color code of the diagram background.
@@ -300,7 +300,7 @@ console.log(gdj1.config.colorDiagramBackground);
 
 #### colorDiagramBackground (set)
 
-Exists as a property of the config property on the GuitarDiagrams object. Sets the HTML color code of the diagram background. 
+Exists as a property of the config property on the GuitarDiagrams object. Sets the HTML color code of the diagram background.
 
 - **Parameters**: {string} The HTML color code of the diagram background.
 - **Return Value**: _None_
@@ -367,6 +367,7 @@ _Example:_
 ```javascript
 gdj1.config.markerStrokeWidth = 1;
 ```
+
 #### markerFontSize (get)
 
 Exists as a property of the config property on the GuitarDiagrams object. Gets the marker's font size.
@@ -394,6 +395,7 @@ _Example:_
 ```javascript
 gdj1.config.markerFontSize = 10;
 ```
+
 #### fretCount (get)
 
 Exists as a property of the config property on the GuitarDiagrams object. Gets the number of frets on the diagram.
@@ -617,6 +619,7 @@ _Example:_
 ```javascript
 gdj1.config.downloadImageEnabled = true;
 ```
+
 ### <a name="guitar-diagrams.js-public-methods"></a>`guitar-diagrams-config.js` Public Methods
 
 _None._

From d9016c46e638065401c54d2557c818c6ac3b9deb Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Wed, 12 Jun 2024 10:42:12 -0700
Subject: [PATCH 25/32] Changed array copy to deep copy

---
 src/guitar-diagrams.mjs | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/guitar-diagrams.mjs b/src/guitar-diagrams.mjs
index b9357ae..c7400ee 100644
--- a/src/guitar-diagrams.mjs
+++ b/src/guitar-diagrams.mjs
@@ -154,7 +154,7 @@ export class GuitarDiagramsJS {
             let stringNamesIndent = this.#config.fretStartingNumber == 0 ? 0 : fretNumberFontSize;
             let posX;
             let posY;
-            let stringNames = this.#config.stringNames;
+            let stringNames = [...this.#config.stringNames]; // deep copy array
 
             // vertical draws string names left to right, but horizontal needs to draw them bottom to top
             if (this.#config.orientHorizontally == true) {
@@ -561,13 +561,13 @@ export class GuitarDiagramsJS {
             const controlClass = 'guitar-diagrams-control';
             const controlClassPrefix = 'guitar-diagrams-';
 
-            let canvasElement = document.getElementById(this.#config.canvasID);
+            const canvasElement = document.getElementById(this.#config.canvasID);
 
-            let controlsDiv = document.createElement('div');
+            const controlsDiv = document.createElement('div');
             controlsDiv.style = 'display: block; margin-top: .5em';
             canvasElement.insertAdjacentElement('afterend', controlsDiv);
 
-            // add the controls in reverse order of display order
+            // add the controls in reverse order of desired display order (last to first)
             // other controls go here
             /*
             if (this.#config.someFeatureEnabled) {

From af67ac88a256eec461976e159cf2a8ab6f0d08c3 Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Wed, 12 Jun 2024 12:57:35 -0700
Subject: [PATCH 26/32] Improving documentation for code owners

---
 .github/workflows/demo-hosting.yml    |   2 +-
 .github/workflows/linting.yml         |   2 +-
 .github/workflows/release-package.yml |   3 +-
 README.md                             |  21 ++++++-----
 docs/code-owner-docs.md               |  48 +++++++++++++++++++++++---
 guitar-diagrams-js-demo.png           | Bin 0 -> 68103 bytes
 6 files changed, 60 insertions(+), 16 deletions(-)
 create mode 100644 guitar-diagrams-js-demo.png

diff --git a/.github/workflows/demo-hosting.yml b/.github/workflows/demo-hosting.yml
index ea5e698..0d11cc0 100644
--- a/.github/workflows/demo-hosting.yml
+++ b/.github/workflows/demo-hosting.yml
@@ -1,4 +1,4 @@
-name: Deploy examples directory to demo.kcarlile.com on main branch releases
+name: Deploy docs/examples/* to demo hosting
 
 on:
   release:
diff --git a/.github/workflows/linting.yml b/.github/workflows/linting.yml
index 766b2bb..d5c5188 100644
--- a/.github/workflows/linting.yml
+++ b/.github/workflows/linting.yml
@@ -1,4 +1,4 @@
-name: Linting
+name: Lint codebase
 
 on:  # yamllint disable-line rule:truthy
   push:
diff --git a/.github/workflows/release-package.yml b/.github/workflows/release-package.yml
index f897b06..0f35012 100644
--- a/.github/workflows/release-package.yml
+++ b/.github/workflows/release-package.yml
@@ -1,8 +1,9 @@
-name: Node.js Package
+name: Build and publish to NPM
 
 on:
   release:
     types: [created]
+    branches: [main]
 
 jobs:
   build:
diff --git a/README.md b/README.md
index 019a1cc..cf0cfb1 100644
--- a/README.md
+++ b/README.md
@@ -15,8 +15,11 @@
 
 _Guitar Diagrams JS_ is an open source JavaScript library for drawing guitar chords and scales on an HTML5 canvas.
 
-Project: <https://github.com/KCarlile/guitar-diagrams-js>\
-Version: [![GitHub Release](https://img.shields.io/github/v/release/KCarlile/guitar-diagrams-js?include_prereleases&logo=github&label=Latest%20version)](https://github.com/KCarlile/guitar-diagrams-js/releases)
+**Project:** <https://github.com/KCarlile/guitar-diagrams-js>\
+**Version:** [![GitHub Release](https://img.shields.io/github/v/release/KCarlile/guitar-diagrams-js?include_prereleases&logo=github&label=Latest%20version)](https://github.com/KCarlile/guitar-diagrams-js/releases)\
+**Demo:** <https://demo.kcarlile.com/guitar-diagrams-js/>
+
+![Guitar Diagrams JS demo image](guitar-diagrams-js-demo.png)
 
 ### Why should you use Guitar Diagrams JS?
 
@@ -65,23 +68,23 @@ Please see the following pages for more information:
 - [`docs/CONTRIBUTING.md`](docs/CONTRIBUTING.md): instructions for contributing to the project
 - [`LICENSE`](LICENSE): license file for the project
 
-## Change Log
+### Site Builders - Technical Information
 
-See the repository's [Releases page](https://github.com/KCarlile/guitar-diagrams-js/releases) for each release and associated release notes.
+You can find the full usage documentation at [`docs/index.md`](docs/index.md) and the API documentation at [`docs/api-docs.md`](docs/api-docs.md). The following information is just a high-level overview of how to use Guitar Diagrams JS.
 
-## Technical Information for Site Builders
+#### Change Log
 
-You can find the full usage documentation at [`docs/index.md`](docs/index.md) and the API documentation at [`docs/api-docs.md`](docs/api-docs.md). The following information is just a high-level overview of how to use Guitar Diagrams JS.
+See the repository's [Releases page](https://github.com/KCarlile/guitar-diagrams-js/releases) for each release and associated release notes.
 
-### More Information
+#### More Information
 
 For more information, please see the [`docs/index.md`](docs/index.md) and [`docs/api-docs.md`](docs/api-docs.md) pages for general usage help and API documentation. See also the [`docs/examples/index.html`](docs/examples/index.html) page for usage examples.
 
-## Technical Information for Code Owners
+### Code Owners - Technical Information
 
 See [`docs/code-owners.md`](docs/code-owners.md) for documentation related to development and deployment.
 
-## Dependency Requirements
+### Dependency Requirements
 
 There are no specific requirements<sup>[1](#footnotes)</sup> for dependencies to use Guitar Diagrams JS other than the standard browser compatibility considerations with CSS, JavaScript, and HTML 5's `<canvas>` tag. Browser compatibility for the `<canvas>` tag can be found on [the MDN `<canvas>` page](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/canvas#browser_compatibility).
 
diff --git a/docs/code-owner-docs.md b/docs/code-owner-docs.md
index 4c291ec..5659884 100644
--- a/docs/code-owner-docs.md
+++ b/docs/code-owner-docs.md
@@ -13,9 +13,13 @@ This documentation page is for code owners to understand the technical details o
     - [`linting.sh`](#lintingsh)
     - [`package-check.sh`](#package-checksh)
     - [`super-linter.sh`](#super-lintersh)
+  - [GitHub Actions](#github-actions)
+  - [Demo Hosting](#demo-hosting)
+    - [Important Note](#important-note)
   - [Building, Packaging, and Releasing](#building-packaging-and-releasing)
     - [Local Builds and Releases](#local-builds-and-releases)
   - [Releases](#releases)
+    - [Versioning](#versioning)
 
 ## Directory Structure
 
@@ -51,7 +55,7 @@ This section outlines the directory structure of the project.
     - `code-owner-docs.md`: This document.
     - `CONTRIBUTING.md`: Community guidelines for contributing to the project.
     - `index.md`: Main documentation landing page.
-    - `index.html`: Documentation with demonstrations of examples for how to use the projet.
+    - `index.html`: Documentation with demonstrations of examples for how to use the project.
     - `testing.html`: Testing page used for development.
 - `src/`: Contains development files.
   - `guitar-diagrams.mjs`: Main entry point for the project.
@@ -96,6 +100,30 @@ This script calls the `npx publint` to check the `package.json` file for correct
 
 This script starts a Docker container to run a local version of Super-Linter for linting HTML, CSS, JS, and Markdown. This can be run as part of the `build.sh` script by running `npm run build` from the root of the project.
 
+## GitHub Actions
+
+There are three workflows defined for GitHub Actions and those exist at the following location:
+
+- `.github/`
+  - `workflows/`
+    - `demo-hosting.yml`
+    - `linting.yml`
+    - `release-package.yml`
+
+| File Name | Workflow Name | Trigger(s) | Branch(es) | Description |
+| --------- | ------------- | ---------- | ---------- | ----------- |
+| Deploy docs/examples/* to demo hosting | `demo-hosting.yml` | Release published | `main` | Copies `docs/examples/*` to @KCarlile's personal GoDaddy hosting via FTP for public demo of functionality at <https://demo.kcarlile.com/guitar-diagrams-js/>. |
+| Lint codebase | `linting.yml` | Push, PR | `main`, `develop` | Runs Super-Linter against HTML, CSS, JS, and Markdown files in the codebase when code is pushed to `main` or `develop` and when a PR is created against `main` or `develop`. |
+| Build and publish to NPM | `release-package.yml` | Release created | `main` | Builds and publishes the project to NPM when release are created on `main`. |
+
+## Demo Hosting
+
+Whenever a release is published, a GitHub Actions workflow runs to FTP the contents of the `docs/examples/` directory to @KCarlile's personal GoDaddy hosting account. This is so the demo examples can be easily viewed by anyone at <https://demo.kcarlile.com/guitar-diagrams-js/>.
+
+### Important Note
+
+The `.scripts/build.sh` script, which is run by calling `npm run build` from the root of the project, copies the JavaScript files from `src/*.mjs` to `docs/examples/js/guitar-diagrams-js/` for local reference for the demo page (`docs/examples/index.html`).
+
 ## Building, Packaging, and Releasing
 
 ### Local Builds and Releases
@@ -107,8 +135,20 @@ This script starts a Docker container to run a local version of Super-Linter for
 
 ## Releases
 
-When you have enough features and bugs merged to justify a release, create a PR from the `develop` branch into `main` branch.
-Once that is merged, use the [Release page](https://github.com/KCarlile/guitar-diagrams-js/releases) to create a new release which will kick off a new package deployment using the GitHub Action workflow defined in `.github/workflows/release-package.yml`.
+When enough changes (bugs and new features) have been merged into the `develop` branch to warrant a new version, create a release with a new version number.
+
+1. Create a PR from the `develop` branch into `main` branch.
+1. Once that PR is merged into `main`, checkout `main` locally and pull to get the latest changes. Then, update the version number in `package.json` in your local `main` branch and commit, then push back up to GitHub. (Release creation will fail if the version in `package.json` is not the same as the version you are creating.)
+1. Use the [Release page](https://github.com/KCarlile/guitar-diagrams-js/releases) to create a new release which will kick off a new package deployment using the GitHub Action workflow defined in `.github/workflows/release-package.yml`.
+
 Once the workflow has completed successfully, the package will be hosted on the [Packages page](https://github.com/KCarlile/guitar-diagrams-js/pkgs/npm/guitar-diagrams-js).
 
-See also [`docs/examples/js/guitar-diagrams-js/README.md`](docs/examples/js/guitar-diagrams-js/README.md) for information about symlinks for local testing and demo deployment information.
+### Versioning
+
+Guitar Diagrams JS uses [semantic versioning](https://semver.org/) with version numbers in the format of X.Y.Z.
+
+| Number | Release Significance | Description | Example |
+| ------ | -------------------- | ----------- | ------- |
+| X | Major | A change in major version denotes new features (and bug fixes) that break backward compatibility. | `1.5.1` :arrow_right: `2.0.0` |
+| Y | Minor | A change in minor version denotes new features (and bug fixes) that retain backward compatibility. | `1.5.1` :arrow_right: `1.6.0` |
+| Z | Patch | A change in patch version denotes bug fixes (no new features) that retain backward compatibility. | `1.5.1` :arrow_right: `1.5.2` |
diff --git a/guitar-diagrams-js-demo.png b/guitar-diagrams-js-demo.png
new file mode 100644
index 0000000000000000000000000000000000000000..d8d327f5e567aa08ad56a98bb9a573871444f79e
GIT binary patch
literal 68103
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

literal 0
HcmV?d00001


From ab0c209bc052a5509cc1547e89ff6f8a736966d0 Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Wed, 12 Jun 2024 12:58:31 -0700
Subject: [PATCH 27/32] Fixing broken link

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index cf0cfb1..a96d291 100644
--- a/README.md
+++ b/README.md
@@ -82,7 +82,7 @@ For more information, please see the [`docs/index.md`](docs/index.md) and [`docs
 
 ### Code Owners - Technical Information
 
-See [`docs/code-owners.md`](docs/code-owners.md) for documentation related to development and deployment.
+See [`docs/code-owner-docs.md`](docs/code-owner-docs.md) for documentation related to development and deployment.
 
 ### Dependency Requirements
 

From 273ad8cd0a5ca69ae42ac82eedf11f9929d77225 Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Wed, 12 Jun 2024 13:00:52 -0700
Subject: [PATCH 28/32] Updating README.md

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index a96d291..5994ab2 100644
--- a/README.md
+++ b/README.md
@@ -50,7 +50,8 @@ GitHub profile: [@KCarlile](https://github.com/KCarlile)
 
  If you contribute to the project in any way (code, documentation, testing, etc.), your name will appear in the list of contributors below:
 
-- Kenny Carlile (project lead/owner)
+- @KCarlile (project lead/owner)
+- @ckreiger1
 - _Your name here_
 
 ## Documentation and Examples

From 816cc891ccbcf669544c1d26606c15b428e9e879 Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Wed, 12 Jun 2024 16:17:04 -0700
Subject: [PATCH 29/32] Renaming addCanvas() method to addCanvasToElement()

---
 docs/examples/index.html                           | 14 +++++++-------
 .../js/guitar-diagrams-js/guitar-diagrams.mjs      | 12 ++++++------
 docs/examples/js/main.js                           | 12 ++++++------
 docs/examples/js/testing.js                        |  2 +-
 docs/index.md                                      | 12 ++++++------
 src/guitar-diagrams.mjs                            |  4 ++--
 6 files changed, 28 insertions(+), 28 deletions(-)

diff --git a/docs/examples/index.html b/docs/examples/index.html
index c4f8428..65808b2 100644
--- a/docs/examples/index.html
+++ b/docs/examples/index.html
@@ -27,7 +27,7 @@ <h2 class="border-bottom border-1 mb-4">Preface - Setup</h2>
                     <pre><code class="language-html">&lt;div id="diagram-1"&gt;&lt;/div&gt;</code></pre>
                     <p>That div's ID doesn't need to be <em>diagram-1</em> as shown, but it needs to be a unique name that
                         you will reference later on in your code, like this:</p>
-                    <pre><code class="language-javascript">gdj1.addCanvas('diagram-1');</code></pre>
+                    <pre><code class="language-javascript">gdj1.addCanvasToElement('diagram-1');</code></pre>
                 </div>
             </div>
             <!-- BEGIN: example 1 -->
@@ -41,7 +41,7 @@ <h2 class="border-bottom border-1 mb-4">Example 1 - Basic fretboard</h2>
                     <h5>Code</h5>
                     <pre><code class="language-javascript">let gdj1 = new GuitarDiagramsJS();
 gdj1.config.canvasID = 'diagram-1-canvas'; // specify the canvas element's an ID
-gdj1.addCanvas('diagram-1'); // add the canvas to the specified element ID on the page
+gdj1.addCanvasToElement('diagram-1'); // add the canvas to the specified element ID on the page
 gdj1.drawNeck(); // draw the fretboard</code></pre>
                 </div>
             </div>
@@ -62,7 +62,7 @@ <h5>Code</h5>
                     <pre><code class="language-javascript">let gdj2 = new GuitarDiagramsJS();
 gdj2.config.canvasID = 'diagram-2-canvas';
 gdj2.config.stringNamesEnabled = true;
-gdj2.addCanvas('diagram-2');
+gdj2.addCanvasToElement('diagram-2');
 gdj2.drawNeck();
 gdj2.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square); // add a square marker on string 1, fret 1, text '1'
 gdj2.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle); // add a triangle marker on string 2, fret 2, text '2'
@@ -99,7 +99,7 @@ <h5>Code</h5>
 gdj3.config.fretStartingNumber = 3; // set starting fret
 gdj3.config.stringNames = ['D','A','D','G']; // set string names and count
 gdj3.config.fretCount = 3; // set starting fret
-gdj3.addCanvas('diagram-3');
+gdj3.addCanvasToElement('diagram-3');
 gdj3.drawNeck();
 gdj3.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square);
 gdj3.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle);
@@ -135,7 +135,7 @@ <h5>Code</h5>
                     <pre><code class="language-javascript">let gdj4 = new GuitarDiagramsJS();
 gdj4.config.canvasID = 'diagram-4-canvas';
 gdj4.config.scaleFactor = .6; // set scaling factor (.6 == 60%)
-gdj4.addCanvas('diagram-4');
+gdj4.addCanvasToElement('diagram-4');
 gdj4.drawNeck();
 gdj4.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square);
 gdj4.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle);
@@ -189,7 +189,7 @@ <h5>Code</h5>
 gdj5.config.colorLabel = '#FFFFFF'; // specify the label color for string names and starting fret
 gdj5.config.markerStrokeWidth = 1; // specify the marker's stroke width
 gdj5.config.markerFontSize = 10; // specify the marker text's font size
-gdj5.addCanvas('diagram-5');
+gdj5.addCanvasToElement('diagram-5');
 gdj5.drawNeck();
 gdj5.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square);
 gdj5.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle);
@@ -224,7 +224,7 @@ <h5>Code</h5>
 gdj6.config.controlsEnabled = true;
 gdj6.config.downloadImageEnabled = true;
 gdj6.config.changeOrientationEnabled = true;
-gdj6.addCanvas('diagram-6');
+gdj6.addCanvasToElement('diagram-6');
 gdj6.drawNeck();
 gdj6.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square);
 gdj6.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle);
diff --git a/docs/examples/js/guitar-diagrams-js/guitar-diagrams.mjs b/docs/examples/js/guitar-diagrams-js/guitar-diagrams.mjs
index b9357ae..e114173 100644
--- a/docs/examples/js/guitar-diagrams-js/guitar-diagrams.mjs
+++ b/docs/examples/js/guitar-diagrams-js/guitar-diagrams.mjs
@@ -154,7 +154,7 @@ export class GuitarDiagramsJS {
             let stringNamesIndent = this.#config.fretStartingNumber == 0 ? 0 : fretNumberFontSize;
             let posX;
             let posY;
-            let stringNames = this.#config.stringNames;
+            let stringNames = [...this.#config.stringNames]; // deep copy array
 
             // vertical draws string names left to right, but horizontal needs to draw them bottom to top
             if (this.#config.orientHorizontally == true) {
@@ -561,13 +561,13 @@ export class GuitarDiagramsJS {
             const controlClass = 'guitar-diagrams-control';
             const controlClassPrefix = 'guitar-diagrams-';
 
-            let canvasElement = document.getElementById(this.#config.canvasID);
+            const canvasElement = document.getElementById(this.#config.canvasID);
 
-            let controlsDiv = document.createElement('div');
+            const controlsDiv = document.createElement('div');
             controlsDiv.style = 'display: block; margin-top: .5em';
             canvasElement.insertAdjacentElement('afterend', controlsDiv);
 
-            // add the controls in reverse order of display order
+            // add the controls in reverse order of desired display order (last to first)
             // other controls go here
             /*
             if (this.#config.someFeatureEnabled) {
@@ -667,9 +667,9 @@ export class GuitarDiagramsJS {
      * Adds the canvas element to the parent element with the specified ID.
      * @param {string} paramParentElementID - The parent element's ID to which the canvas element will be added.
      */
-    addCanvas(paramParentElementID) {
+    addCanvasToElement(paramParentElementID) {
         document.getElementById(paramParentElementID).appendChild(this.getCanvasElement());
-    } // end addCanvas method
+    } // end addCanvasToElement method
 
     /**
      * Sets the canvas element's ID for an existing canvas.
diff --git a/docs/examples/js/main.js b/docs/examples/js/main.js
index 7251d7d..143b2b5 100644
--- a/docs/examples/js/main.js
+++ b/docs/examples/js/main.js
@@ -13,7 +13,7 @@ import { GuitarDiagramsJS } from './guitar-diagrams-js/guitar-diagrams.mjs';
 // ========== BEGIN example 1
 let gdj1 = new GuitarDiagramsJS();
 gdj1.config.canvasID = 'diagram-1-canvas'; // specify the canvas element's an ID
-gdj1.addCanvas('diagram-1'); // add the canvas to the specified element ID on the page
+gdj1.addCanvasToElement('diagram-1'); // add the canvas to the specified element ID on the page
 gdj1.drawNeck(); // draw the fretboard
 // ========== END example 1
 
@@ -21,7 +21,7 @@ gdj1.drawNeck(); // draw the fretboard
 let gdj2 = new GuitarDiagramsJS();
 gdj2.config.canvasID = 'diagram-2-canvas';
 gdj2.config.stringNamesEnabled = true;
-gdj2.addCanvas('diagram-2');
+gdj2.addCanvasToElement('diagram-2');
 gdj2.drawNeck();
 gdj2.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square); // add a square marker on string 1, fret 1, text '1'
 gdj2.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle); // add a triangle marker on string 2, fret 2, text '2'
@@ -41,7 +41,7 @@ gdj3.config.orientHorizontally = true; // set horizontal orientation
 gdj3.config.fretStartingNumber = 3; // set starting fret
 gdj3.config.stringNames = ['D','A','D','G']; // set string names and count
 gdj3.config.fretCount = 3; // set starting fret
-gdj3.addCanvas('diagram-3');
+gdj3.addCanvasToElement('diagram-3');
 gdj3.drawNeck();
 gdj3.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square);
 gdj3.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle);
@@ -57,7 +57,7 @@ gdj3.drawAllMarkers();
 let gdj4 = new GuitarDiagramsJS();
 gdj4.config.canvasID = 'diagram-4-canvas';
 gdj4.config.scaleFactor = .6; // set scaling factor (.6 == 60%)
-gdj4.addCanvas('diagram-4');
+gdj4.addCanvasToElement('diagram-4');
 gdj4.drawNeck();
 gdj4.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square);
 gdj4.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle);
@@ -84,7 +84,7 @@ gdj5.config.colorDiagramBackground = '#000000'; // specify the diagram backgroun
 gdj5.config.colorLabel = '#FFFFFF'; // specify the label color for string names and starting fret
 gdj5.config.markerStrokeWidth = 1; // specify the marker's stroke width
 gdj5.config.markerFontSize = 10; // specify the marker text's font size
-gdj5.addCanvas('diagram-5');
+gdj5.addCanvasToElement('diagram-5');
 gdj5.drawNeck();
 gdj5.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square);
 gdj5.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle);
@@ -103,7 +103,7 @@ gdj6.config.stringNamesEnabled = true;
 gdj6.config.controlsEnabled = true;
 gdj6.config.downloadImageEnabled = true;
 gdj6.config.changeOrientationEnabled = true;
-gdj6.addCanvas('diagram-6');
+gdj6.addCanvasToElement('diagram-6');
 gdj6.drawNeck();
 gdj6.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square);
 gdj6.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle);
diff --git a/docs/examples/js/testing.js b/docs/examples/js/testing.js
index b49fa94..02c4683 100644
--- a/docs/examples/js/testing.js
+++ b/docs/examples/js/testing.js
@@ -22,7 +22,7 @@ gdjTesting.config.enableAllControls();
 //gdjTesting.config.changeOrientationEnabled = true;
 
 //gdj4.config.scaleFactor = .5;
-gdjTesting.addCanvas('diagram-testing');
+gdjTesting.addCanvasToElement('diagram-testing');
 gdjTesting.drawNeck();
 gdjTesting.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square);
 gdjTesting.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle);
diff --git a/docs/index.md b/docs/index.md
index 51abbd7..ffae2c4 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -37,7 +37,7 @@ If you want to use a CDN-hosted package (e.g., Guitar Diagrams JS on JSDelivr at
 </script>
 ```
 
-Be sure to add some target HTML element to your page with a matching ID (`gdj1.addCanvas('diagram-1');` where `'diagram-1'` is the ID) in your JS code so Guitar Diagrams JS knows where to add your drawing:
+Be sure to add some target HTML element to your page with a matching ID (`gdj1.addCanvasToElement('diagram-1');` where `'diagram-1'` is the ID) in your JS code so Guitar Diagrams JS knows where to add your drawing:
 
 ```html
 <div id="diagram-1"></div>
@@ -62,7 +62,7 @@ You can also install this package manually by downloading it, placing the files
    </script>
    ```
 
-1. Be sure to add some target HTML element to your page with a matching ID (`gdj1.addCanvas('diagram-1');` where `'diagram-1'` is the ID) in your JS code so Guitar Diagrams JS knows where to add your drawing:
+1. Be sure to add some target HTML element to your page with a matching ID (`gdj1.addCanvasToElement('diagram-1');` where `'diagram-1'` is the ID) in your JS code so Guitar Diagrams JS knows where to add your drawing:
 
    ```html
    <div id="diagram-1"></div>
@@ -89,7 +89,7 @@ After your import statement, add the JavaScript to associate your block-level el
 ```javascript
 let gdj1 = new GuitarDiagramsJS();
 gdj1.config.canvasID = 'diagram-1-canvas';
-gdj1.addCanvas('diagram-1');
+gdj1.addCanvasToElement('diagram-1');
 gdj1.drawNeck();
 ```
 
@@ -99,7 +99,7 @@ This will result in the most basic guitar diagram of a blank fretboard. The foll
 | ---- | ---- | ----------- | ----- |
 | 1 | `let gdj1 = new GuitarDiagramsJS();`| Instantiate a new `GuitarDiagramsJS` object and assign it to the `gdj1` variable|  |
 | 2 | `gdj1.config.canvasID = 'diagram-1-canvas';` | Set the canvasID value of the gdj1's config object to `'diagram-1-canvas'` | `'diagram-1-canvas'` is a unique ID for the `<canvas>` HTML element that will be added to your HTML within the block-level element. This ID is important so you can reference it later if you want to style the canvas itself. |
-| 3 | `gdj1.addCanvas('diagram-1');` | Add the Guitar Diagrams JS HTML `<canvas>` element to the parent block-level HTML element as specified by the element's unique ID | The ID string being passed here is the one specified in your HTML, like the example above: ```<div id="diagram-1"></div>``` |
+| 3 | `gdj1.addCanvasToElement('diagram-1');` | Add the Guitar Diagrams JS HTML `<canvas>` element to the parent block-level HTML element as specified by the element's unique ID | The ID string being passed here is the one specified in your HTML, like the example above: ```<div id="diagram-1"></div>``` |
 | 4 | `gdj1.drawNeck();` | Draw the neck of the diagram with the previously specified parameters |  |
 
 See _Example 1_ on the [Examples page](examples/index.html).
@@ -112,7 +112,7 @@ To add markers to a diagram, after calling `gdj1.drawNeck();`, you'll need to sp
 let gdj2 = new GuitarDiagramsJS();
 gdj2.config.canvasID = 'diagram-2-canvas';
 gdj2.config.stringNamesEnabled = true;
-gdj2.addCanvas('diagram-2');
+gdj2.addCanvasToElement('diagram-2');
 gdj2.drawNeck();
 gdj2.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square);
 gdj2.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle);
@@ -130,7 +130,7 @@ This will result in a basic guitar fretboard diagram with 7 different markers ad
 | ---- | ---- | ----------- | ----- |
 | 1 | `let gdj2 = new GuitarDiagramsJS();`| Instantiate a new `GuitarDiagramsJS` object and assign it to the `gdj1` variable|  |
 | 2 | `gdj2.config.canvasID = 'diagram-2-canvas';` | Set the canvasID value of the gdj1's config object to `'diagram-2-canvas'` | `'diagram-2-canvas'` is a unique ID for the `<canvas>` HTML element that will be added to your HTML within the block-level element. This ID is important so you can reference it later if you want to style the canvas itself. |
-| 3 | `gdj1.addCanvas('diagram-2');` | Add the Guitar Diagrams JS HTML `<canvas>` element to the parent block-level HTML element as specified by the element's unique ID | The ID string being passed here is the one specified in your HTML, like the example above, but with a different ID for diagram 2: ```<div id="diagram-2"></div>``` |
+| 3 | `gdj1.addCanvasToElement('diagram-2');` | Add the Guitar Diagrams JS HTML `<canvas>` element to the parent block-level HTML element as specified by the element's unique ID | The ID string being passed here is the one specified in your HTML, like the example above, but with a different ID for diagram 2: ```<div id="diagram-2"></div>``` |
 | 4 | `gdj1.drawNeck();` | Draw the neck of the diagram with the previously specified parameters |  |
 | 5 | `gdj2.addMarker(1, 1, '1', GuitarDiagramsJS.Shape.Square);` | Adds a marker on the string 1, fret 1, with text "1", and square shape |  |
 | 6 | `gdj2.addMarker(2, 2, '2', GuitarDiagramsJS.Shape.Triangle);` | Adds a marker on the string 2, fret 2, with text "2", and triangle shape |  |
diff --git a/src/guitar-diagrams.mjs b/src/guitar-diagrams.mjs
index c7400ee..e114173 100644
--- a/src/guitar-diagrams.mjs
+++ b/src/guitar-diagrams.mjs
@@ -667,9 +667,9 @@ export class GuitarDiagramsJS {
      * Adds the canvas element to the parent element with the specified ID.
      * @param {string} paramParentElementID - The parent element's ID to which the canvas element will be added.
      */
-    addCanvas(paramParentElementID) {
+    addCanvasToElement(paramParentElementID) {
         document.getElementById(paramParentElementID).appendChild(this.getCanvasElement());
-    } // end addCanvas method
+    } // end addCanvasToElement method
 
     /**
      * Sets the canvas element's ID for an existing canvas.

From 3d963a263d3c6e93ff2d5c01442cf7cbd785cd83 Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Wed, 12 Jun 2024 17:04:35 -0700
Subject: [PATCH 30/32] Updating README.md with example sites and instructions

---
 README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/README.md b/README.md
index 5994ab2..c3ce67e 100644
--- a/README.md
+++ b/README.md
@@ -69,6 +69,15 @@ Please see the following pages for more information:
 - [`docs/CONTRIBUTING.md`](docs/CONTRIBUTING.md): instructions for contributing to the project
 - [`LICENSE`](LICENSE): license file for the project
 
+### Site Builder Examples
+
+If you're a site builder using Guitar Diagrams JS, your site should be featured here as an example of how to use this library. Please [submit an Issue](https://github.com/KCarlile/guitar-diagrams-js/issues/new/choose) with a link to your site, plus any links to specific pages using Guitar Diagrams JS, and it will be added to the list below.
+
+**Example sites:**
+
+- [Guitar Diagrams JS demo/examples](https://demo.kcarlile.com/guitar-diagrams-js/)
+- _Your site here!_
+
 ### Site Builders - Technical Information
 
 You can find the full usage documentation at [`docs/index.md`](docs/index.md) and the API documentation at [`docs/api-docs.md`](docs/api-docs.md). The following information is just a high-level overview of how to use Guitar Diagrams JS.

From 67bbe17ac1f8788b8b14ab6e089b204842ffecb1 Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Wed, 12 Jun 2024 21:15:14 -0700
Subject: [PATCH 31/32] Updating issue templates and links.

---
 .github/ISSUE_TEMPLATE/01-bug-report.md       | 10 +++++++---
 .github/ISSUE_TEMPLATE/02-feature-request.md  |  4 ++--
 .github/ISSUE_TEMPLATE/03-usage-submission.md | 20 +++++++++++++++++++
 README.md                                     |  2 +-
 docs/code-owner-docs.md                       |  1 +
 5 files changed, 31 insertions(+), 6 deletions(-)
 create mode 100644 .github/ISSUE_TEMPLATE/03-usage-submission.md

diff --git a/.github/ISSUE_TEMPLATE/01-bug-report.md b/.github/ISSUE_TEMPLATE/01-bug-report.md
index dc2e58b..99ff939 100644
--- a/.github/ISSUE_TEMPLATE/01-bug-report.md
+++ b/.github/ISSUE_TEMPLATE/01-bug-report.md
@@ -1,7 +1,7 @@
 ---
-name: Bug report
-about: Create a report to help us improve
-title: "[Bug]"
+name: Bug
+about: Submit a bug describing a problematic behavior
+title: "[Bug title]"
 labels: bug
 assignees: ''
 
@@ -11,6 +11,10 @@ assignees: ''
 
 A description of the bug and how you found it, including steps to reproduce and notable parameters such as browser and OS. Also include how the system should have behaved. Provide screenshots if applicable.
 
+## Steps to Reproduce
+
+Describe the steps to reproduce the issue.
+
 ## Acceptance Criteria
 
 - Bulleted list of what would constitute this bug being resolved
diff --git a/.github/ISSUE_TEMPLATE/02-feature-request.md b/.github/ISSUE_TEMPLATE/02-feature-request.md
index 179deb7..6566ede 100644
--- a/.github/ISSUE_TEMPLATE/02-feature-request.md
+++ b/.github/ISSUE_TEMPLATE/02-feature-request.md
@@ -1,7 +1,7 @@
 ---
 name: Feature request
-about: Feature Request or Enhancement
-title: "[Feature or enhancement request]"
+about: Submit a new feature idea or enhancement request
+title: "[Feature or enhancement request title]"
 labels: enhancement
 assignees: ''
 
diff --git a/.github/ISSUE_TEMPLATE/03-usage-submission.md b/.github/ISSUE_TEMPLATE/03-usage-submission.md
new file mode 100644
index 0000000..efe3fb6
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/03-usage-submission.md
@@ -0,0 +1,20 @@
+---
+name: Usage submission
+about: Submit a site using this project as an example of usage
+title: "[Site name]"
+labels: usage
+assignees: ''
+
+---
+
+## Site
+
+Provide the URL for your site.
+
+## Usage Examples
+
+Provide a list of any URLs for pages within your site that demonstrate usage of the project.
+
+## Comments
+
+Add any other comments or thoughts about your usage of the project.
diff --git a/README.md b/README.md
index c3ce67e..5969149 100644
--- a/README.md
+++ b/README.md
@@ -71,7 +71,7 @@ Please see the following pages for more information:
 
 ### Site Builder Examples
 
-If you're a site builder using Guitar Diagrams JS, your site should be featured here as an example of how to use this library. Please [submit an Issue](https://github.com/KCarlile/guitar-diagrams-js/issues/new/choose) with a link to your site, plus any links to specific pages using Guitar Diagrams JS, and it will be added to the list below.
+If you're a site builder using Guitar Diagrams JS, your site should be featured here as an example of how to use this library. Please [submit an issue of Usage Submission type](https://github.com/KCarlile/guitar-diagrams-js/issues/new?labels=usage&template=03-usage-submission.md&title=%5BSite%20name%5D) with a link to your site, plus any links to specific pages using Guitar Diagrams JS, and it will be added to the list below.
 
 **Example sites:**
 
diff --git a/docs/code-owner-docs.md b/docs/code-owner-docs.md
index 5659884..8fc73d2 100644
--- a/docs/code-owner-docs.md
+++ b/docs/code-owner-docs.md
@@ -32,6 +32,7 @@ This section outlines the directory structure of the project.
   - `ISSUE_TEMPLATE/`: Markdown files for GitHub issue templates.
     - `01-bug-report.md`: Template for GitHub issues of type bug.
     - `02-feature-request.md`: Template for GitHub issues of type feature request.
+    - `03-usage-submission.md`: Template for GitHub issues of type usage submission.
     - `config.yml`: GitHub Actions config.
   - `workflows/`: YML files to define GitHub Actions.
     - `demo-hosting.yml`: GitHub Actions workflow to deploy `examples/` content to GoDaddy hosting for demos.

From e9784aea7c94598db0b8360db3eaec18ddfba3cb Mon Sep 17 00:00:00 2001
From: Kenny Carlile <kennycarlile@gmail.com>
Date: Wed, 12 Jun 2024 21:23:43 -0700
Subject: [PATCH 32/32] Fixing MD validation

---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 5969149..4057b6d 100644
--- a/README.md
+++ b/README.md
@@ -71,7 +71,8 @@ Please see the following pages for more information:
 
 ### Site Builder Examples
 
-If you're a site builder using Guitar Diagrams JS, your site should be featured here as an example of how to use this library. Please [submit an issue of Usage Submission type](https://github.com/KCarlile/guitar-diagrams-js/issues/new?labels=usage&template=03-usage-submission.md&title=%5BSite%20name%5D) with a link to your site, plus any links to specific pages using Guitar Diagrams JS, and it will be added to the list below.
+If you're a site builder using Guitar Diagrams JS, your site should be featured here as an example of how to use this library.
+Please [submit an issue of Usage Submission type](https://github.com/KCarlile/guitar-diagrams-js/issues/new?labels=usage&template=03-usage-submission.md&title=%5BSite%20name%5D) with a link to your site, plus any links to specific pages using Guitar Diagrams JS, and it will be added to the list below.
 
 **Example sites:**