From 43fbd7acf8f8a8a7b9e709777a5104a25f3ecd91 Mon Sep 17 00:00:00 2001
From: The-red-masque <110782407+The-red-masque@users.noreply.github.com>
Date: Mon, 17 Mar 2025 22:26:39 -0700
Subject: [PATCH 1/4] Cleaned up syntax

Cleaned up markdown syntax errors and added in <!-- markdownlint-disable MD033 --> in order to make reading the markdown easier.
---
 content/en/docs/get-started/assembly.md | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/content/en/docs/get-started/assembly.md b/content/en/docs/get-started/assembly.md
index f771fda..2781e82 100644
--- a/content/en/docs/get-started/assembly.md
+++ b/content/en/docs/get-started/assembly.md
@@ -16,8 +16,9 @@ toc: true
 {{< alert icon="⚠️" context="warning" text="Assembly video coming by Sep 10 2024." />}}
 
 <!-- #update# -->
-
+<!-- markdownlint-disable MD033 -->
 ## ⚙ Parts
+
 ![](/images/CutieCat/v0_CutieCat-Parts.png)
 
 <!-- ![](/images/CutieCat/v0_CutieCat-Package.png) -->
@@ -38,6 +39,7 @@ For more tips, check out our soldering guide. -->
 ## 🗒 Steps
 
 ### 1. Place the ESP32
+
 <div id="Step-1" class="carousel slide" data-bs-ride="carousel">
   <div class="carousel-inner">
     <div class="carousel-item active">
@@ -65,11 +67,12 @@ For more tips, check out our soldering guide. -->
 </br>
 
 - Start by melting a small "tack" of solder to one of the CutieCat microcontroller pads.  This will help us place the ESP32 before committing.
-- Center the ESP32 on the microcontroller footprint.  
+- Center the ESP32 on the microcontroller footprint.
 - Reheat the tack of solder until it melts, while pressing down the ESP32.  Don't worry about how the first joint looks!
 - Let the solder cool!  If you need to readjust the microcontroller, simply reheat the joint.
 
 ### 2. Solder the ESP32
+
 {{< alert icon="⚠️" context="danger" text="Be extra careful not to burn the switch connector, or bridge neighboring pins." />}}
 <div id="Step-2" class="carousel slide" data-bs-ride="carousel">
   <div class="carousel-inner">
@@ -104,6 +107,7 @@ For more tips, check out our soldering guide. -->
 **Switch connector will be moved in update v0.1 design*
 
 ### 3. Solder the Expansion Header
+
 <div id="Step-3" class="carousel slide" data-bs-ride="carousel">
   <div class="carousel-inner">
     <div class="carousel-item active">
@@ -128,8 +132,8 @@ For more tips, check out our soldering guide. -->
 - b. Lay the board & header flush on a flat surface
 - c. Solder the joints!
 
-
 ### 4. Prep + Solder the Screen
+
 {{< alert icon="⚠️" context="warning" text="Press down on center of screen - the edges are really fragile!" />}}
 <div id="Step-4" class="carousel slide" data-bs-ride="carousel">
   <div class="carousel-inner">
@@ -160,6 +164,7 @@ For more tips, check out our soldering guide. -->
 <!-- note: correct screen askew -->
 
 ### 5. Antenna & Case Assembly
+
 {{< alert icon="🛈" context="warning" text="Read our long-range mod guide before adding the external antenna!!" />}}
 <div id="Step-5" class="carousel slide" data-bs-ride="carousel">
   <div class="carousel-inner">
@@ -183,13 +188,14 @@ For more tips, check out our soldering guide. -->
   </button>
 </div>
 </br>
- 
+
 - a. Snap the patch antenna onto the ESP32 u.fl connector
 - b. Insert the D-Pad into the Top Enclosure
 - c. Place the CutieCat in face-down
 - d. Snap-on the Back Enclosure!
 
 ### 6. Quality Assurance
+
 ![](/images/update.JPG)
 
 - Plug in your CutieCat with USB Type C
@@ -199,6 +205,7 @@ For more tips, check out our soldering guide. -->
 {{< alert icon="🛈" context="danger" text="If your board doesn't work, check our troubleshooting guide." />}}
 
 ## 🔧 Additional Mods
+
 ![](/images/update.JPG)
 
 Check out our [mods]() section for more, including adding the long-range antenna!

From a550d895026f35a800cc84b9320b5126e741dd39 Mon Sep 17 00:00:00 2001
From: The-red-masque <110782407+The-red-masque@users.noreply.github.com>
Date: Mon, 17 Mar 2025 23:08:33 -0700
Subject: [PATCH 2/4] Added alt-text

Added alt-text when I knew what was going on and added "..." with the note "I don't know what is happening in these pictures so I can't help" where I didn't know what to add
---
 content/en/docs/get-started/assembly.md | 27 ++++++++++++++-----------
 1 file changed, 15 insertions(+), 12 deletions(-)

diff --git a/content/en/docs/get-started/assembly.md b/content/en/docs/get-started/assembly.md
index 2781e82..3117353 100644
--- a/content/en/docs/get-started/assembly.md
+++ b/content/en/docs/get-started/assembly.md
@@ -19,8 +19,8 @@ toc: true
 <!-- markdownlint-disable MD033 -->
 ## ⚙ Parts
 
-![](/images/CutieCat/v0_CutieCat-Parts.png)
-
+![v0 CutieCat Parts](/images/CutieCat/v0_CutieCat-Parts.png)
+<!-- Note: all images that I couldn't figure out what was happening  have alt "..." so that they can be found quicker. -->
 <!-- ![](/images/CutieCat/v0_CutieCat-Package.png) -->
 
 | Part | Description |
@@ -43,15 +43,15 @@ For more tips, check out our soldering guide. -->
 <div id="Step-1" class="carousel slide" data-bs-ride="carousel">
   <div class="carousel-inner">
     <div class="carousel-item active">
-      <img src="/images/CutieCat/Soldering-Guide/Step-1.1.png" class="d-block w-100" alt="">
+      <img src="/images/CutieCat/Soldering-Guide/Step-1.1.png" class="d-block w-100" alt="Melt a tack of solder onto the top right pad">
       <div class="carousel-caption d-none d-md-block">
-          <p>a. Melt a tack of solder onto the top right pad.</p>
+          <p>Melt a tack of solder onto the top right pad.</p>
       </div>
     </div>
     <div class="carousel-item active">
-      <img src="/images/CutieCat/Soldering-Guide/Step-1.2.png" class="d-block w-100" alt="...">
+      <img src="/images/CutieCat/Soldering-Guide/Step-1.2.png" class="d-block w-100" alt="Reheat the blob and place the microcontroller!">
       <div class="carousel-caption d-none d-md-block">
-          <p>b. Reheat the blob and place the microcontroller!</p>
+          <p>Reheat the blob and place the microcontroller!</p>
       </div>
     </div>
   </div>
@@ -77,13 +77,13 @@ For more tips, check out our soldering guide. -->
 <div id="Step-2" class="carousel slide" data-bs-ride="carousel">
   <div class="carousel-inner">
     <div class="carousel-item active">
-      <img src="/images/CutieCat/Soldering-Guide/Step-2.1.png" class="d-block w-100" alt="">
+      <img src="/images/CutieCat/Soldering-Guide/Step-2.1.png" class="d-block w-100" alt="Text over image of devkitty board "Soldering iron vertical to board. Stay clear of Switch Connector">
       <!-- <div class="carousel-caption d-none d-md-block">
           <p>a</p>
       </div> -->
     </div>
     <div class="carousel-item active">
-      <img src="/images/CutieCat/Soldering-Guide/Step-2.2.png" class="d-block w-100" alt="...">
+      <img src="/images/CutieCat/Soldering-Guide/Step-2.2.png" class="d-block w-100" alt="Soldering pins">
       <div class="carousel-caption d-none d-md-block">
           <p>Solder the rest of the pins!</p>
       </div>
@@ -108,6 +108,7 @@ For more tips, check out our soldering guide. -->
 
 ### 3. Solder the Expansion Header
 
+<!-- I don't know what is happening in these pictures so I can't help -->
 <div id="Step-3" class="carousel slide" data-bs-ride="carousel">
   <div class="carousel-inner">
     <div class="carousel-item active">
@@ -134,11 +135,12 @@ For more tips, check out our soldering guide. -->
 
 ### 4. Prep + Solder the Screen
 
+<!-- I don't know what is happening in these pictures so I can't help -->
 {{< alert icon="⚠️" context="warning" text="Press down on center of screen - the edges are really fragile!" />}}
 <div id="Step-4" class="carousel slide" data-bs-ride="carousel">
   <div class="carousel-inner">
     <div class="carousel-item active">
-      <img src="/images/CutieCat/Soldering-Guide/Step-4.1.png" class="d-block w-100" alt="">
+      <img src="/images/CutieCat/Soldering-Guide/Step-4.1.png" class="d-block w-100" alt="...">
     </div>
     <div class="carousel-item active">
       <img src="/images/CutieCat/Soldering-Guide/Step-4.2.png" class="d-block w-100" alt="...">
@@ -165,11 +167,12 @@ For more tips, check out our soldering guide. -->
 
 ### 5. Antenna & Case Assembly
 
+<!-- I don't know what is happening in these pictures so I can't help -->
 {{< alert icon="🛈" context="warning" text="Read our long-range mod guide before adding the external antenna!!" />}}
 <div id="Step-5" class="carousel slide" data-bs-ride="carousel">
   <div class="carousel-inner">
     <div class="carousel-item active">
-      <img src="/images/CutieCat/Soldering-Guide/Step-5.1.png" class="d-block w-100" alt="">
+      <img src="/images/CutieCat/Soldering-Guide/Step-5.1.png" class="d-block w-100" alt="...">
     </div>
     <div class="carousel-item active">
       <img src="/images/CutieCat/Soldering-Guide/Step-5.2.png" class="d-block w-100" alt="...">
@@ -196,7 +199,7 @@ For more tips, check out our soldering guide. -->
 
 ### 6. Quality Assurance
 
-![](/images/update.JPG)
+![Updated photo coming soon!](/images/update.JPG)
 
 - Plug in your CutieCat with USB Type C
 - With your board fully assembled, it should power on the QA Firmware!
@@ -206,7 +209,7 @@ For more tips, check out our soldering guide. -->
 
 ## 🔧 Additional Mods
 
-![](/images/update.JPG)
+![Updated photo coming soon!](/images/update.JPG)
 
 Check out our [mods]() section for more, including adding the long-range antenna!
 

From c0deb3f83f3792328947ce3d0971010bade4dba3 Mon Sep 17 00:00:00 2001
From: The-red-masque <110782407+The-red-masque@users.noreply.github.com>
Date: Mon, 17 Mar 2025 23:24:00 -0700
Subject: [PATCH 3/4] Changed to ordered lists

Changed unordered lists and semi-ordered lists to ordered lists. Added some more alt-text when I understood more.
---
 content/en/docs/get-started/assembly.md | 44 ++++++++++++-------------
 1 file changed, 22 insertions(+), 22 deletions(-)

diff --git a/content/en/docs/get-started/assembly.md b/content/en/docs/get-started/assembly.md
index 3117353..8b8ef34 100644
--- a/content/en/docs/get-started/assembly.md
+++ b/content/en/docs/get-started/assembly.md
@@ -66,10 +66,10 @@ For more tips, check out our soldering guide. -->
 </div>
 </br>
 
-- Start by melting a small "tack" of solder to one of the CutieCat microcontroller pads.  This will help us place the ESP32 before committing.
-- Center the ESP32 on the microcontroller footprint.
-- Reheat the tack of solder until it melts, while pressing down the ESP32.  Don't worry about how the first joint looks!
-- Let the solder cool!  If you need to readjust the microcontroller, simply reheat the joint.
+1. Start by melting a small "tack" of solder to one of the CutieCat microcontroller pads.  This will help us place the ESP32 before committing.
+2. Center the ESP32 on the microcontroller footprint.
+3. Reheat the tack of solder until it melts, while pressing down the ESP32.  Don't worry about how the first joint looks!
+4. Let the solder cool!  If you need to readjust the microcontroller, simply reheat the joint.
 
 ### 2. Solder the ESP32
 
@@ -100,9 +100,9 @@ For more tips, check out our soldering guide. -->
 </div>
 </br>
 
-- a. Solder each remaining pad on the microcontroller!
-- b. Ensure the connection is solid by bridging the ESP32 pad & PCB pads
-- c. Avoid burning the switch connector! *
+1. Solder each remaining pad on the microcontroller!
+2. Ensure the connection is solid by bridging the ESP32 pad & PCB pads
+3. Avoid burning the switch connector! *
 
 **Switch connector will be moved in update v0.1 design*
 
@@ -129,9 +129,9 @@ For more tips, check out our soldering guide. -->
 </div>
 </br>
 
-- a. Insert the 6-Pin Header on the Side
-- b. Lay the board & header flush on a flat surface
-- c. Solder the joints!
+1. Insert the 6-Pin Header on the Side
+2. Lay the board & header flush on a flat surface
+3. Solder the joints!
 
 ### 4. Prep + Solder the Screen
 
@@ -160,9 +160,9 @@ For more tips, check out our soldering guide. -->
 </div>
 </br>
 
-- a. Add double-sided foam tape at the bottom of the screen footprint (not pictured)
-- b. Center & press the screen in place.
-- c. Solder the screen joints on the back.
+1. Add double-sided foam tape at the bottom of the screen footprint (not pictured)
+2. Center & press the screen in place.
+3. Solder the screen joints on the back.
 <!-- note: correct screen askew -->
 
 ### 5. Antenna & Case Assembly
@@ -175,10 +175,10 @@ For more tips, check out our soldering guide. -->
       <img src="/images/CutieCat/Soldering-Guide/Step-5.1.png" class="d-block w-100" alt="...">
     </div>
     <div class="carousel-item active">
-      <img src="/images/CutieCat/Soldering-Guide/Step-5.2.png" class="d-block w-100" alt="...">
+      <img src="/images/CutieCat/Soldering-Guide/Step-5.2.png" class="d-block w-100" alt="Insert the D-pad into the Top Enclosure">
     </div>
     <div class="carousel-item active">
-      <img src="/images/CutieCat/Soldering-Guide/Step-5.3.png" class="d-block w-100" alt="...">
+      <img src="/images/CutieCat/Soldering-Guide/Step-5.3.png" class="d-block w-100" alt="Snap-on Back Enclosure.">
     </div>
   </div>
   <button class="carousel-control-prev" type="button" data-bs-target="#Step-5" data-bs-slide="prev">
@@ -192,18 +192,18 @@ For more tips, check out our soldering guide. -->
 </div>
 </br>
 
-- a. Snap the patch antenna onto the ESP32 u.fl connector
-- b. Insert the D-Pad into the Top Enclosure
-- c. Place the CutieCat in face-down
-- d. Snap-on the Back Enclosure!
+1. Snap the patch antenna onto the ESP32 u.fl connector
+2. Insert the D-Pad into the Top Enclosure
+3. Place the CutieCat in face-down
+4. Snap-on the Back Enclosure!
 
 ### 6. Quality Assurance
 
 ![Updated photo coming soon!](/images/update.JPG)
 
-- Plug in your CutieCat with USB Type C
-- With your board fully assembled, it should power on the QA Firmware!
-- Check out our [Firmware Guide]() to load new firmware.
+1. Plug in your CutieCat with USB Type C
+2. With your board fully assembled, it should power on the QA Firmware!
+3. Check out our [Firmware Guide]() to load new firmware.
 
 {{< alert icon="🛈" context="danger" text="If your board doesn't work, check our troubleshooting guide." />}}
 

From 01ba477f5b2b96aaeb4473ac0ac738e1c2d8fe79 Mon Sep 17 00:00:00 2001
From: The-red-masque <110782407+The-red-masque@users.noreply.github.com>
Date: Mon, 17 Mar 2025 23:34:21 -0700
Subject: [PATCH 4/4] Added link to firmware

Added link to firmware and added a note at the top for readability.
---
 content/en/docs/get-started/assembly.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/content/en/docs/get-started/assembly.md b/content/en/docs/get-started/assembly.md
index 8b8ef34..89e00e1 100644
--- a/content/en/docs/get-started/assembly.md
+++ b/content/en/docs/get-started/assembly.md
@@ -20,7 +20,10 @@ toc: true
 ## ⚙ Parts
 
 ![v0 CutieCat Parts](/images/CutieCat/v0_CutieCat-Parts.png)
+
 <!-- Note: all images that I couldn't figure out what was happening  have alt "..." so that they can be found quicker. -->
+<!-- Note: There weren't any links to mods that I was able to find on devkitty.io -->
+
 <!-- ![](/images/CutieCat/v0_CutieCat-Package.png) -->
 
 | Part | Description |
@@ -203,7 +206,7 @@ For more tips, check out our soldering guide. -->
 
 1. Plug in your CutieCat with USB Type C
 2. With your board fully assembled, it should power on the QA Firmware!
-3. Check out our [Firmware Guide]() to load new firmware.
+3. Check out our [Firmware Guide](https://devkitty.io/docs/get-started/firmware/) to load new firmware.
 
 {{< alert icon="🛈" context="danger" text="If your board doesn't work, check our troubleshooting guide." />}}