New structure, final safety article and pics

Author: sntxerror

README.md

@@ -4,6 +4,8 @@ Welcome to the official MICRORACK documentation. MICRORACK is the most accessibl
 
 ## Quick Start
 
+<!-- todo: use styled tiles with links to sections for each part of the docs -->
+
 New to MICRORACK? Start here:
 
 1. **[System Setup](setup/)** — Unbox, power up, and make your first sound
@@ -41,6 +43,15 @@ Open hardware specification for module designers. *(Fetched on site build)*
 
 ---
 
+## Open Platform
+
+MICRORACK is an open platform. Any enthusiast or brand can create and distribute compatible modules and accessories.
+
+- **Specification License:** [CERN Open Hardware Licence (CERN-OHL-W)](https://specs.microrack.org/LICENSE.md)
+- **Contribute:** Submit modules, documentation improvements, or community designs via GitHub
+
+---
+
 ## Resources
 
 | Resource | Link |
@@ -53,13 +64,4 @@ Open hardware specification for module designers. *(Fetched on site build)*
 
 ---
 
-## Open Platform
-
-MICRORACK is an open platform. Any enthusiast or brand can create and distribute compatible modules.
-
-- **Specification License:** [CERN Open Hardware Licence (CERN-OHL-W)](https://specs.microrack.org/LICENSE.md)
-- **Contribute:** Submit modules, documentation improvements, or community designs via GitHub
-
----
-
-*Built with ❤️ by the MICRORACK team and community.*
+*Built with ❤️ by the MICRORACK Team.*

ecosystem/70-community/README.md ecosystem/60-community/README.mdecosystem/70-community/README.md renamed to ecosystem/60-community/README.md

@@ -1,84 +1,104 @@
-# Safety & Orientation
+# Safe Usage Guidelines
 
-MICRORACK is designed to be a safe and robust platform for experimentation. Following a few simple rules will ensure your modules live a long and happy life.
+MICRORACK is designed to be open but safe and robust platform for hacking and experimentation. Following a few simple rules and recommendations below will ensure that your modules live a long and happy life.
 
-## The "Look for the Notch" Rule
+## Modules alignment
 
-Every MICRORACK module has a distinct **triangular cutout (notch)** at the bottom of the PCB. This is your orientation guide.
+Every MICRORACK module has a distinct **triangular cutout (notch)** on the PCB. It helps to orientate modules and properly place them on your breadboard with **notch at the bottom**.
 
-| Correct | Incorrect |
-|---------|-----------|
-| Notch at **bottom** | Notch at top |
-| Power pins align with rails | Module won't work |
-| Module functions normally | No damage, just no function |
+![Cutout orientation example](cutouts.png)
 
-### How to Check
-
-1. Hold the module with the components facing you
-2. Look for the triangular notch (60 mil / 1.52mm deep)
-3. The notch should point toward the **bottom** of your breadboard (usually the side closest to you)
-4. Insert the module so the power pins seat firmly in the power rails
-
-> **FYI:** If you accidentally plug a module in backwards, don't panic! MICRORACK modules include **reverse polarity protection** — they simply won't work until you flip them around. No smoke, no damage.
+> **FYI:** All MICRORACK modules polarities are protected, so if you accidentally plug a module in backwards  — they simply won't work until you align power rails properly.
 
 ## Electrical Safety
 
-### Voltage Levels
-
-MICRORACK operates on low voltage (±12V, +5V DC). It is safe to touch the modules while powered.
+![Touch safety](touch.png)
 
-| Safety Aspect | Status |
-|---------------|--------|
-| Shock hazard | ✅ None (low voltage) |
-| Module touch-safe | ✅ Yes |
-| Reverse insertion | ✅ Protected |
+MICRORACK operates on low voltage (±12V, +5V DC). It is safe to touch the modules while powered. Some modules are even designed to be touched intentionally. However, please follow these guidelines:
 
 ### Avoid Short Circuits
 
-- Don't drop metal objects (loose wires, paperclips) onto the powered breadboard
-- This can short the power rails and potentially damage your power supply
-- If you hear a "pop" or see smoke, disconnect power immediately
+![Safety donts](donts.png)
+
+- It's not recommended to use modules without a breadboard, expose bottom pins and components while powered
+- Don't drop or put metal objects (exposed or loose wires, paperclips, etc.) onto the powered breadboard
+- Keep liquids away from the breadboard and modules
+
+> ⚠️**Warning:** If you spill water on the device, smell or see smoke, disconnect power immediately!
 
 ### Hot-Swapping
 
-While MICRORACK modules are designed to tolerate hot-swapping:
+While MICRORACK modules are designed to tolerate hot-swapping **the best practice** is to power off your setup before rearranging.
+
+**It is fine** to carefully insert or remove modules while everything is powered on but requires an extra bit of caution.
 
-| Approach | Recommendation |
-|----------|----------------|
-| **Best practice** | Power off before adding/removing modules |
-| **Acceptable** | Careful insertion with power on |
-| **Avoid** | Rapid or careless module swapping while powered |
+![Careful insertion](insert.png)
 
-> **Why?** Hot-swapping can cause brief voltage transients. Modules are protected, but powering off first is always safer.
+Entangled wires can accidentally pull other modules, so **it's better** to avoid swapping modules while they are patched.
 
-## Handling Modules
+For hot-swap **we recommend** to turn the volume off and disconnect the patch wires from the module before you remove it on the fly.
+
+It is also **advisable to avoid** swapping I/O modules while they are directly connected to other sensitive devices (headphones, speakers, microphones, recorders, midi-devices, mixers, audio interfaces).
+
+> **Why:** Hot-swapping can cause brief signal spikes and transients while your other equipment might be sensitive to it. We cannot protect your external devices or records from incorrect usage so its recommended to lower the volume, unpatch or even power off first.
+
+## Handling
 
 ### Pin Headers
 
-- The male pin headers on the underside are robust but can bend
-- If pins get bent, gently straighten them with needle-nose pliers
-- Avoid forcing bent pins into the breadboard
+The **male pin headers** on the PCBs are robust and durable, but they can sometimes bend. You can notice it if a module or wire does not fit properly.
+
+> **Do not use force:** If you feel resistance while inserting cable or module please avoid forced connection or pushing bent pins into the breadboard!
+
+![Bent pins](bent.png)
+
+Its easy to just carefully straighten the pins yourself, with pliers or a simple flat screwdriver.
+
+### Connections
+
+All modules use same standard 0.1" (2.54mm) pitch male headers while cables have female connectors.
+
+We provide compatible wire sets with each kit. These include silicon patch wires, alligator clips and jumpers.
+
+![Connections](coonnections.png)
+
+You can use standard Eurorack patch cables, instrument Jacks and MIDI connections as well, just ensure stable module and breadboard mounting, especially with bigger or heavier connectors.
+
+> **Tip:** It's a good practice to reset values of the knobs on the module before patching to avoid unexpected spikes or sounds during performance or recording.  
 
 ### Static Electricity
 
-Like all electronics, modules can be sensitive to static discharge:
+Like all electronics, modules can be sensitive to static discharge so its recommended to touch a grounded metal object before handling modules (especially in dry environments).
 
-- Touch a grounded metal object before handling modules (especially in dry environments)
-- Store modules in anti-static bags when not in use
+- Store modules in non-conductive container when not in use
 - Avoid handling modules on carpet or synthetic surfaces
 
-## Quick Safety Checklist
+### Cleaning
+
+**Use plastic brush** to remove dust from the modules. For heavy cleaning, you can apply IPA (Isopropyl Alcohol) to the brush.
+
+**Avoid washing buttons and potentiometers** with IPA. It can cause issues with their contact surfaces.
+
+Avoid using cotton, liquids other than IPA, tools or abrasive materials that could damage or corrode the PCB or components.
+
+### Storage
+
+When not in use, store modules enclosed, in a dry, dust-free environment. Use anti-static bags, boxes with foam inserts, or plastic containers to protect the device.
+
+## Quick Checklist
 
 Before powering on:
 
 - ☐ All modules inserted with **notch at bottom**
 - ☐ Power Module firmly seated in power rails
+- ☐ Volume turned down on Output Module
 - ☐ No loose wires or metal objects on the breadboard
-- ☐ Power supply connected and correct polarity
+- ☐ Power supply has correct interface (Type-C or DC Jack), voltage rating (5V-12V) and polarity (Center-Positive)
 
 ## Still Unsure?
 
-If you're worried about a specific connection or orientation:
+If you're worried about a specific feature or usage scenario, please don't hesitate to:
 
-- **Post a photo:** [Forum Safety Section](https://forum.microrack.org/c/support) — get quick confirmation from experienced users
-- **Check the specs:** [Mechanical Specification](https://specs.microrack.org/mechanical/) for detailed diagrams
+- **Post a question:** [Forum Support Thread](https://forum.microrack.org/c/support) — get quick confirmation from experienced users or the team
+- **Check the Specs:** [Mechanical Specification](https://specs.microrack.org/) for description of power, size and connection standards
+- **Modules List:** [List of Compatible Modules](https://modules.microrack.org/) for info on each compatible module and its features