push v2

_config.yml

@@ -36,3 +36,9 @@ nav_external_links:
 # Back to top link
 back_to_top: true
 back_to_top_text: "Back to top"
+
+# Nice boxes for visibility
+callouts:
+  warning:
+    title: tip
+    color: blue

dilemma_build_guide/v1.md

@@ -5,6 +5,8 @@ nav_order: 4
 parent: Dilemma Build guides
 ---
 
+# Table of contents
+
 1. TOC
 {:toc}
 
@@ -16,15 +18,15 @@ parent: Dilemma Build guides
 - Solder the reset button
 - Do the same thing for the left (in yellow on the picture below).
 
-![](assets/../../assets/pics/guides/dilemmav1/1.jpg)
+![](../assets/pics/guides/dilemmav1/1.jpg)
 
 # Soldering the audio jacks
 
 - Flip the boards
 - Solder in the audio jacks
 - Check that orientation is the same as on the picture below
 
-![](assets/../../assets/pics/guides/dilemmav1/2.jpg)
+![](../assets/pics/guides/dilemmav1/2.jpg)
 
 # Preparing the trackpad assembly
 
@@ -39,19 +41,19 @@ Install the 5 screw inserts:
 -  Move the parts aside and let them rest, while they cool down
 
 
-![](assets/../../assets/pics/guides/dilemmav1/3.jpg)
+![](../assets/pics/guides/dilemmav1/3.jpg)
 
 
 Install the left 3d print holder. Do not screw it in completely, we will do this later.
 
 
-![](assets/../../assets/pics/guides/dilemmav1/4.jpg)
+![](../assets/pics/guides/dilemmav1/4.jpg)
 
 - Slide the trackpad into the assembly. Align the notch, just like on the picture below (at the bottom)
 - Screw in the retainer
 
 
-![](assets/../../assets/pics/guides/dilemmav1/5.jpg)
+![](../assets/pics/guides/dilemmav1/5.jpg)
 
 # Connecting the trackpad ribbon cable
 
@@ -60,35 +62,35 @@ Please note: you do not need to desolder any resistors on the trackpad. Just use
 Bend the cable like on the picture below :
 
 
-![](assets/../../assets/pics/guides/dilemmav1/6.jpg)
+![](../assets/pics/guides/dilemmav1/6.jpg)
 
 
 - On the Right side of the keyboard, pass the cable from the top in the hole, just like in the picture below
 - Open the ribbon connector
 
 
-![](assets/../../assets/pics/guides/dilemmav1/7.jpg)
+![](../assets/pics/guides/dilemmav1/7.jpg)
 
 - Insert the ribbon in the connector
 - Make sure you have the same orientation as in the picture below - blue facing up !
 - Close the ribbon connector
 
 
-![](assets/../../assets/pics/guides/dilemmav1/8.jpg)
+![](../assets/pics/guides/dilemmav1/8.jpg)
 
 # Connecting the trackpad assembly
 
 - Connect the other side of the ribbon cable into the trackpad assembly
 - Make sure you install it like on the picture below - the blue part on the same side as the black dot
 
 
-![](assets/../../assets/pics/guides/dilemmav1/9.jpg)
+![](../assets/pics/guides/dilemmav1/9.jpg)
 
 Screw in the trackpad assembly. Tighten all 4 screws.
 
 When installing it, you will need to rotate the assembly and twist the cable. Be careful with it, and avoid fiddling with it as it can break easily.
 
-![](assets/../../assets/pics/guides/dilemmav1/10.jpg)
+![](../assets/pics/guides/dilemmav1/10.jpg)
 
 # Test the PCB
 
@@ -106,6 +108,6 @@ Solder in your switches of preference.
 
 You're all done !
 
-Head over to https://bstkbd.com/custom to customize your keyboard to your needs.
+Head over to [bstkbd.com/custom](https://bstkbd.com/custom) to customize your keyboard to your needs.
 
-If you need any help with it, make sure to hop on the discord : https://bstkbd.com/discord
+If you need any help with it, make sure to hop on the discord : [bstkbd.com/discord](https://www.bstkbd.com/discord)

dilemma_build_guide/v2.md

@@ -5,6 +5,84 @@ nav_order: 5
 parent: Dilemma Build guides
 ---
 
+# Table of contents
+
 1. TOC
 {:toc}
 
+# Install the per-key RGB
+
+-   If you have per-key RGB in your kit, install those first.-   Make sure that the Gnd pad aligns ! -   The Gnd pad of the Led is the one with the cutout (top right pin on the picture)-   The Gnd pad on the PCB is the one with the cutout, and white circle (top right on the picture)
+
+![](../assets/pics/guides/dilemmav2/1.jpg)
+
+# Soldering the audio jacks and reset buttons
+
+-   There is only one way the components can be installed, so there's no risk of messing up !-   Solder in the audio jacks-   Solder in the reset buttons-   **When installing the reset button, take care not to short the pads to the vias nearby.** The vias are the round metal holes.
+
+![](assets/../../assets/pics/guides/dilemmav2/2.jpg)
+
+# Preparing the trackpad assembly
+
+Install the 5 screw inserts:
+
+-   Set your soldering iron temperature to 200 degrees Celsius-   To make it easier, use a plier to hold the 3d print
+
+![](assets/../../assets/pics/guides/dilemmav2/3.jpg)
+
+-   Using the soldering iron, place the heated insert inside the hole-   *Apply little to no pressure, let the gravity do the work*. Otherwise, you might push them too far-   If the insert doesn't fall into place, you can slowly increase the temperature, but don't go over 300 degrees-   Once the insert is 2/3 of the way in, stop-   Flip over the print and gradually push it against a flat surface, to make the insert flush with the print-   Move the parts aside and let them rest, while they cool down
+
+![](../assets/pics/guides/dilemmav2/4.jpg)
+
+{: .tip }
+The kit comes with grey screws. If you ordered a case, you will also get black screws. For this step, use the grey screws. 
+
+-   Install the first part of the 3d print holder on the right side PCB. **Do not screw it in completely**, we will do this later.
+
+![](../assets/pics/guides/dilemmav2/5.jpg)
+
+-   Slide the trackpad into the assembly. Align the notch, just like on the picture below (at the bottom)-   Screw in the retainer
+
+![](../assets/pics/guides/dilemmav2/6.jpg)
+
+# Connecting the trackpad ribbon cable
+
+**Please note**: you **do not need** to desolder any resistors on the trackpad. Just **use it as it came in the kit !**
+
+-   On the **Right side of the keyboard**,-   Open the FPC connector-   Slide the cable in like on the picture below-   Close the FPC connector
+
+![](../assets/pics/guides/dilemmav2/7.jpg)
+
+-   Slide the other end of the cable into the slot
+
+![](../assets/pics/guides/dilemmav2/8.jpg)
+
+# Connecting the trackpad assembly
+
+-   Connect the other side of the ribbon cable into the trackpad assembly-   **Make sure you install it like on the picture below - the blue part on the same side as the black dot**
+
+![](../assets/pics/guides/dilemmav2/9.jpg)
+
+-   If you don't have a case, screw in the 4 screws and tighten them like on the picture below.-   If you have a case, read the instructions in the case page, after installing the switches.
+
+![](../assets/pics/guides/dilemmav2/10.jpg)
+
+# Test the PCB
+
+This step is optional, but highly recommended.
+
+- Connect the keyboard to your computer - it comes pre-flashed with QMK
+- Check that the cursor moves when you use the trackpad
+- Using tweezers, short 2 pins of a switch. Check that it registers
+
+# Soldering the switches
+
+Solder in your switches of preference.
+
+# Customize your firmware
+
+You're all done !
+
+Head over to [bstkbd.com/custom](https://bstkbd.com/custom) to customize your keyboard to your needs.
+
+If you need any help with it, make sure to hop on the discord : [bstkbd.com/discord](https://www.bstkbd.com/discord)