Add version 1, update to work with multiple versions

README.cs.md

@@ -8,10 +8,10 @@
 Pájecí challenge je skvělý způsob jak se naučit pájet SMD součástky.
 
 <div align="center">
-    <img src="/docs/media/solderingChallenge-2.png">
+    <img src="/docs/media/solderingChallenge-v2/solderingChallenge-2.png">
 </div>
 
-[Návod na pájení](assembly.md){ .md-button .md-button--primary }
+[Návod na pájení](assembly/index.md){ .md-button .md-button--primary }
 
 Pájecí výzva spočívá v zapájení všech součástek na DPS v co nejkratším čase.
 
@@ -26,7 +26,7 @@ Pájecí výzva spočívá v zapájení všech součástek na DPS v co nejkratš
 Pokud se ti podaří správně zapájet všechny součástky, tak po zapojení do USB portu začne LED blikat s frekvencí cca 2 Hz.
 
 <div align="center">
-    <img src="/docs/media/schema.png">
+    <img src="/docs/media/solderingChallenge-v2/schema.png">
 </div>
 
 !!! info "Pozor, L2 má prohozený rezistor R1 a R2"

README.md

@@ -8,10 +8,10 @@
 Solving the SMD soldering challenge is a great way to learn how to solder SMD components.
 
 <div align="center">
-    <img src="/docs/media/solderingChallenge-2.png">
+    <img src="/docs/media/solderingChallenge-v2/solderingChallenge-2.png">
 </div>
 
-[Soldering Instructions](assembly.md){ .md-button .md-button--primary }
+[Soldering Instructions](assembly/index.md){ .md-button .md-button--primary }
 
 The challenge is to solder all the components on the PCB in the shortest time possible.
 
@@ -26,7 +26,7 @@ The challenge is to solder all the components on the PCB in the shortest time po
 If you manage to plug in all the components correctly, the LED will flash at about 2 Hz when plugged into the USB port.
 
 <div align="center">
-    <img src="/docs/media/schema.png">
+    <img src="/docs/media/solderingChallenge-v2/schema.png">
 </div>
 
 !!! info "Attention, L2 has swapped resistor R1 and R2"

docs/README.cs.md

@@ -8,10 +8,10 @@
 Pájecí challenge je skvělý způsob jak se naučit pájet SMD součástky.
 
 <div align="center">
-    <img src="/media/solderingChallenge-2.png">
+    <img src="/media/solderingChallenge-v2/solderingChallenge-2.png">
 </div>
 
-[Návod na pájení](assembly.md){ .md-button .md-button--primary }
+[Návod na pájení](assembly/index.md){ .md-button .md-button--primary }
 
 Pájecí výzva spočívá v zapájení všech součástek na DPS v co nejkratším čase.
 
@@ -26,7 +26,7 @@ Pájecí výzva spočívá v zapájení všech součástek na DPS v co nejkratš
 Pokud se ti podaří správně zapájet všechny součástky, tak po zapojení do USB portu začne LED blikat s frekvencí cca 2 Hz.
 
 <div align="center">
-    <img src="/media/schema.png">
+    <img src="/media/solderingChallenge-v2/schema.png">
 </div>
 
 !!! info "Pozor, L2 má prohozený rezistor R1 a R2"

docs/README.md

@@ -8,10 +8,10 @@
 Solving the SMD soldering challenge is a great way to learn how to solder SMD components.
 
 <div align="center">
-    <img src="/media/solderingChallenge-2.png">
+    <img src="/media/solderingChallenge-v2/solderingChallenge-2.png">
 </div>
 
-[Soldering Instructions](assembly.md){ .md-button .md-button--primary }
+[Soldering Instructions](assembly/index.md){ .md-button .md-button--primary }
 
 The challenge is to solder all the components on the PCB in the shortest time possible.
 
@@ -23,10 +23,10 @@ The challenge is to solder all the components on the PCB in the shortest time po
 - Level 5 - SMD 0201 components (PCB is not complete) -->
 
 
-If you manage to solder all the components correctly, the LED will flash about 2 times per second when plugged into the USB port.
+If you manage to plug in all the components correctly, the LED will flash at about 2 Hz when plugged into the USB port.
 
 <div align="center">
-    <img src="/media/schema.png">
+    <img src="/media/solderingChallenge-v2/schema.png">
 </div>
 
-!!! info "Attention, L2 has swapped resistor R1 and R2"
+!!! info "Attention, L2 has swapped resistor R1 and R2"

docs/assembly/index.cs.md

@@ -0,0 +1,9 @@
+# Osazovací návod
+
+## Vyber si verzi
+
+### Verze 1 - 2021
+[![Version 1](/media/solderingChallenge-v1/solderingChallenge.png)](version-1.md)
+
+### Verze 2 - 2023
+[![Version 2](/media/solderingChallenge-v2/solderingChallenge.png)](version-2.md)

docs/assembly/index.md

@@ -0,0 +1,10 @@
+# Soldering Instructions
+
+
+## Choose a version
+
+### Version 1
+[![Version 1](/media/solderingChallenge-v1/solderingChallenge.png)](version-1.md)
+
+### Version 2
+[![Version 2](/media/solderingChallenge-v2/solderingChallenge.png)](version-2.md)

docs/assembly/version-1.cs.md

@@ -0,0 +1,59 @@
+# Osazovací návod - V1
+
+Verze z roku 2021
+
+## Jak postupovat
+
+- **Vždy pájej pouze jednu úroveň najednou.**
+- Vždy si vezmi jednu součástku, tu zapájej a až pak pokračuj s další.
+- Pak můžeš zapájet ostatní součástky.
+- Jakmile máš zapájeno, nalep zespodu USB konektoru podložku.
+
+!!! info "Důležité informace"
+	- Začni připájením integrovaného obvodu.
+    	- U integrovaného obvodu si pohlídej jeho orientaci. Pokud si nejsi jistý, zeptej se lektora.
+  	- Jako poslední připájej LED
+	- U LED běžně na polaritě záleží. Na této desce však polaritu řešit nemusíte, obvod je navržen tak, aby na polaritě nezáleželo.
+
+
+
+!!! danger "Bezpečnost práce"
+	- Hrot páječky je horký (~300 °C).
+	- Páječku vždy odkládejte do stojanu.
+	- Udržujte pořádek na pracovišti.
+	- Když se popálíte, tak si běžte popálené místo zchladit vodou, případně ledem. Popálené místo ničím nemastěte.
+
+
+## L0
+![](/media/solderingChallenge-v1/solderingChallenge-L0.png)
+
+!!! Pozor danger
+    Pozor, u kondenzátoru 4.7u záleží na polaritě. Popisek kondenzátoru
+    musí směřovat <span style="color:red">**ven**</span> desky. Zeptej se lektora, pokud si nejsi jistý.
+
+
+## L1 - THT
+![](/media/solderingChallenge-v1/solderingChallenge-L1.png)
+
+!!! Pozor danger
+    Pozor, u kondenzátoru 4.7u záleží na polaritě. Popisek kondenzátoru
+    musí směřovat <span style="color:red">**ven**</span> z desky (obráceně než u L0). Zeptej se lektora, pokud si nejsi jistý.
+
+## L2 - 1206
+![](/media/solderingChallenge-v1/solderingChallenge-L2.png)
+
+## L3 - 0603
+![](/media/solderingChallenge-v1/solderingChallenge-L3.png)
+
+## L4 - 0402
+![](/media/solderingChallenge-v1/solderingChallenge-L4.png)
+
+## L5 - BGA + 0201
+![](/media/solderingChallenge-v1/solderingChallenge-L5.png)
+
+## Jak to funguje?
+
+Pokud tě zajímá, jak funguje obvod, který jsi právě zapájel, podívej se např. na
+[tento web](https://www.mylms.cz/zapojeni-casovace-555/). Tam se dočteš, jak
+funguje integrovaný obvod 555. V naší pájecí výzvě používáme takzvané *astabilní
+zapojení* neboli *multivibrátor*, který je na výše zmíněné stránce vysvětlen.

docs/assembly/version-1.md

@@ -0,0 +1,48 @@
+# Soldering Instructions - V1
+
+Version from 2021
+
+## How to Proceed
+
+- **Always solder only one level at a time.**
+- Take one component from the holder, solder it, and only after that take another one. (They are easy to mixup.)
+- Once you have soldered everything, glue a padding underneath the USB connector.
+
+!!! info "Important Information"
+    - Start by soldering the integrated circuit. As last solder the LED.
+        - Be mindful of the orientation of the integrated circuit. If you're unsure, ask the instructor.
+	- Polarity usually matters with LEDs. However, on this board, you don't have to worry about polarity; the circuit is designed to be polarity-agnostic.
+
+!!! danger "Work Safety"
+	- The tip of the soldering iron is hot (~300 °C).
+	- Always place the soldering iron back in its stand.
+	- Keep your workspace tidy.
+	- If you get burned, go and cool the burned area with water (do not use ice). Don't rub anything on the burned area.
+
+## L0
+![](/media/solderingChallenge-v1/solderingChallenge-L0.png)
+
+!!! Danger danger
+	Attention, the polarity of the 4.7u capacitor matters. The capacitor's label
+	must point <span style="color:red">**outwards**</span> from the board. Ask the instructor if you're unsure.
+
+
+
+## L1 - THT
+![](/media/solderingChallenge-v1/solderingChallenge-L1.png)
+
+!!! Danger danger
+	Attention, the polarity of the 4.7u capacitor matters. The capacitor's label
+	must point <span style="color:red">**outwards**</span> from the board (opposite to L0). Ask the instructor if you're unsure.
+
+## L2 - 1206
+![](/media/solderingChallenge-v1/solderingChallenge-L2.png)
+
+## L3 - 0603
+![](/media/solderingChallenge-v1/solderingChallenge-L3.png)
+
+## L4 - 0402
+![](/media/solderingChallenge-v1/solderingChallenge-L4.png)
+
+## L5 - BGA + 0201
+![](/media/solderingChallenge-v1/solderingChallenge-L5.png)

docs/assembly.cs.md → docs/assembly/version-2.cs.md

@@ -1,4 +1,6 @@
-# Osazovací návod
+# Osazovací návod - V2
+
+Verze z roku 2023
 
 ## Jak postupovat
 
@@ -24,15 +26,15 @@
 
 ## L1 - THT
 
-![](/media/solderingChallenge-L1.png){: style="width:300px"}
+![](/media/solderingChallenge-v2/solderingChallenge-L1.png){: style="width:300px"}
 
 
 ## L2 - 1206
-![](/media/solderingChallenge-L2.png){: style="width:300px"}
+![](/media/solderingChallenge-v2/solderingChallenge-L2.png){: style="width:300px"}
 
 
 !!! info "Pozor, L2 má stejné rezistory R2 a R3. R1 je zde jiný"
 
 
 ## L3 - 0603
-![](/media/solderingChallenge-L3.png){: style="width:300px"}
+![](/media/solderingChallenge-v2/solderingChallenge-L3.png){: style="width:300px"}

docs/assembly.md → docs/assembly/version-2.md

@@ -1,4 +1,6 @@
-# Soldering Instructions
+# Soldering Instructions - V2
+
+Version from 2023
 
 ## How to Proceed