Merge pull request #9 from finrod09/master

Add "testing before case installation" sections

.wordlist.txt

@@ -81,3 +81,7 @@ overtighten
 Kapton
 Din
 Dout
+Keycaps
+Pseudoku
+Asymplex
+daughterboard

Gemfile

@@ -9,3 +9,5 @@ gem "just-the-docs", "0.7.0" # pinned to the current release
 gem "jekyll-remote-theme"
 
 gem "jekyll-default-layout"
+
+gem "json" # work around upstream bug (?)

_config.yml

@@ -15,6 +15,7 @@ exclude:
   - Gemfile.lock
   - _site/
   - building-locally.md
+  - cspell.config.yaml
 
 plugins:
   - jekyll-default-layout

_includes/splinktegrated_preparation.md

@@ -65,7 +65,7 @@ In this section, we will solder headers to the PCB. **They will be close to some
 ![](../assets/pics/guides/splinktegrated/7.jpg)
 
 - Inspect the front of the assembly: 
-- Make sure that the headers are flush with the motherboard and daugtherboard
+- Make sure that the headers are flush with the motherboard and daughterboard
 - Solder the top headers, then the bottom headers
 - Finally, cut the headers to make them flush using pliers
 
@@ -151,7 +151,7 @@ In the next section, we will prepare the first Splinktegrated by installing the
 ![](../assets/pics/guides/splinktegrated/8.jpg)
 
 - Inspect the front of the assembly: 
-- Make sure that the headers are flush with the motherboard and daugtherboard
+- Make sure that the headers are flush with the motherboard and daughterboard
 - Solder the top headers, then the bottom headers
 - Finally, cut the headers to make them flush using pliers
 
@@ -213,4 +213,4 @@ You now have 2 Splinktegrated assemblies. Make sure they match with the pictures
 
 ![](../assets/pics/guides/splinktegrated/23.jpg)
 
-![](../assets/pics/guides/splinktegrated/24.jpg)
+![](../assets/pics/guides/splinktegrated/24.jpg)

_includes/testing_pcb.md

@@ -0,0 +1,37 @@
+# Testing the PCBs
+
+Now is a great time to function test the assembled PCBs, as any troubleshooting steps you might need to complete will be much easier to do while the plates are still outside of the case.
+
+{: .note }
+The TRRS connection will not work yet, as only ony one leg of the jack is connected. You can test this part later.
+
+**For the following step, please prepare** a pair of tweezers that are conductive. If you don't have any, you can also use a piece of wire, or a single switch.
+
+## Testing the LEDs
+
+If you have installed per-key LEDs, let's start with testing those.
+If you don't have any per-key RGB installed, you can skip to the next section.
+
+- connect one half to your PC via USB, and observe the LEDs:
+- do they all light up? 
+- are the colors correct?
+- can you see a rainbow animation play?
+
+Does everything look fine? Great, go ahead with testing the switches. 
+
+If not, reflowing the pads of the LEDs not working should do the trick. Please see [Troubleshooting]({{site.baseurl}}/help/troubleshooting.html#one-or-more-leds-dont-work) for details.
+
+## Testing the switches
+
+To test the switches, we are going to use the VIA interface. All Bastard Keyboards come pre-flashed with VIA, so you don't have to flash anything.
+
+Open [VIA](https://usevia.app/) - please note this only works on chromium-based browsers like chromium, edge, chrome.
+
+![](../assets/pics/guides/generic/7.jpg)
+
+After connecting to your device, switch to the key tester page using the stethoscope pictogram, then activate the "Test Matrix" option. Now, you can connect each pair of switch pads in turn, using your tweezers, a wire, or a switch inclined enough.
+
+
+![](../assets/pics/guides/generic/8.jpg)
+
+Did all the keys light up in VIA? Great, proceed to case installation! Not quite perfect yet? Don't worry, proceed to the [Troubleshooting]({{site.baseurl}}/help/troubleshooting.html) section!

bg_charybdis/10install_the_switches.md

@@ -10,6 +10,8 @@ parent: Build guide - Charybdis
 1. TOC
 {:toc}
 
+{% include testing_pcb.md %}
+
 # Introduction
 
 Now that everything is connected together, the next step is to install the switches and the PCBs into the case. The process is exactly the same for both sides, so we will detail only the Scylla side (without trackball).

bg_cnano/10install_the_switches.md

@@ -10,6 +10,7 @@ parent: Build guide - Charybdis Nano
 1. TOC
 {:toc}
 
+{% include testing_pcb.md %}
 
 # Introduction
 

bg_scylla/10install_the_switches.md

@@ -10,6 +10,8 @@ parent: Build guide - Scylla
 1. TOC
 {:toc}
 
+{% include testing_pcb.md %}
+
 # Introduction
 
 Now that everything is connected together, the next step is to install the switches and the PCBs into the case. The process is exactly the same for both sides, so we will detail only the Scylla side (without trackball).
@@ -38,4 +40,4 @@ When installing the switches, use the following technique:
 - start with the top two switches (labeled 1, in red on the picture)
 - continue with the outer four switches (labeled 2, in blue on the picture)
 - continue with the bottom six switches (labeled 3, in green on the picture)
-- finally, install the rest of the switches
+- finally, install the rest of the switches

bg_skeletyl/10install_the_switches.md

@@ -10,6 +10,7 @@ parent: Build guide - Skeletyl
 1. TOC
 {:toc}
 
+{% include testing_pcb.md %}
 
 # Introduction