Padawan Doku first commit

doc/de/teil_0:prolog.md

@@ -0,0 +1,39 @@
+# RTFM: Pentabug
+
+## Vorwort
+
+Lieber Junghacker-Padawan,
+
+dies ist die Dokumentation zum [Pentabug-Projekt](https://github.com/c3d2/pentabug).
+
+Wenn Du sie liest und verinnerlichst, wirst Du Deinen Pentabug von innen bis
+aussen kennen. Du wirst wissen, wie er entstanden ist, wie er aufgebaut ist,
+welche Fähigkeiten er besitzt und wie Du ihn erweitern kannst.
+
+Doch viel mehr wirst Du selbst gelernt haben, ein Projekt wie den Pentabug zu
+realisieren. Du wirst zum Junghacker-Jedi.
+
+## Struktur dieser Dokumentation
+
+Diese Dokumentation ist in verschiedene Teile aufgebaut.
+Wir fangen ganz von vorne an und gehen bis ganz zum Ende. 
+Danach gehen wir noch weiter nach vorne und enden noch weiter hinten.
+
+So kommst Du ganz ohne Basiswissen schnell zu ergebnissen und brauchst nur
+jeweils so viel lesen, wie Dich interessiert.
+
+Teil 1: [Episode 2 - Das Gelöt von Pentabug](teil_1:episode_2.md)  
+Teil 2: Episode 3 - Mögen die Bits mit Dir sein  
+Teil 3: Episode 1 - Layout und Ätzen  
+
+
+# Teil 1: [Episode 2 - Das Gelöt von Pentabug](teil_1:episode_2.md)  
+
+Inhalt soll werden: 
+ - Funktionen des Pentabug 
+ - Wie findet man den richtigen Lötkolben
+ - Wie lötet man richtig.
+ - Was machtjedes Bauteil
+
+# Teil 2: Episode 3 - Mögen die Bits mit Dir sein  TODO
+# Teil 3: Episode 1 - Layout und Ätzen TODO

doc/de/teil_1:episode_2.md

@@ -0,0 +1,104 @@
+# Das Gelöt von Pentabug
+
+In dieser Episode erfährst Du, junger Padawan, was Dein Pentabug so kann, wie
+Du ihn zusammenbaust und dann zum Leben erweckst.
+
+## Was kann son Pentabug eigentlich?
+
+Der Pentabug ist ein kleiner Roboter, den Du selbst zusammebauen und
+programieren kannst.  Er ist recht einfach gehalten und gerade für Einsteiger
+im Bereich der Elektronik besonders gut geeignet.
+
+Der Pentabug kann leuchten, piepen, sich bewegen, auf Geräusche reagieren,
+Infrarot senden und empfangen. Das kann man zum einen dafür nutzen, dass sich
+verschiedene Pentabugs unterhalten, zum anderen aber auch um Geräte
+fernzusteuern. Zudem ist er erweiterbar, d.h. man kann recht einfach weitere
+kleine Schaltungen bauen, die seine Funktionen erweitern.
+
+## Voraussetzungen
+
+Wenn Du einen Pentabug bauen möchtest benötigst Du neben einem Pentabug-Bausatz folgende weitere Dinge:
+
+1. 1 Lötkolben
+2. 1 Schwämmchen, feucht. Ein feuchtes Tuch tut es auch.
+3. Lötzinn.
+4. 1 hitzebeständige Arbeitsunterlage (z.B. kleines Holzbrett oder eine Pappe).
+5. 1 Heißklebepistole mit Kleber
+6. 1 Seitenschneider
+7. 1 Spitzzange (nicht unbedingt zwingend)
+
+Für den Fall, dass Du mal fehler machst, benötigst Du weitere Dinge:
+
+8. 1 Multimeter
+9. 1 Lötlutsche und / oder Entlötlitze
+
+### Auswahl des Lötkolbens und des Lötzinns
+
+Der Lötkolben ist ein Werkzeug mit dem man die verschiedenen elektornischen
+Bauelemente mit einander verbindet. Er wird mit Strom betrieben und wird sehr
+heiß.  Diese Hitze nutzt man um Lötzinn zum schmelzen zu bringen, welches dann
+sozusagen die elektrischen Bauelemente elektrisch leitend mit einander
+verklebt.
+
+Wenn Du noch keinen Lötkolben zur Verfügung hast, also jetzt loslaufen möchtest
+um Dir einen zu besorgen, achte darauf, dass er mindestens 25 Watt hat. Wenn er
+mehr Watt hat, macht das Löten allerdings mehr Spass, da man pro Lötstelle
+nicht so lange auf das Heißwerden warten muss.
+
+Die Spitze sollte nicht zu dick sein; einen Feinlötkolben benötigst Du für
+dieses Projekt allerdings auch nicht.
+
+Überlege, ob Du gleich eine kleine Lötstation kaufst. Die hat meistens gleich
+einen Halter für den Kolben, ein kleines Schwämmchen dabei und man kann die
+Leistung des Lötkolbens regeln.
+
+Ein Beispiel für einen ausreichendes Lötgeröt findet Ihr
+[hier](http://www.amazon.de/dp/B000UNM0QY/). [Disclaimer] Da ist auch schon gleich eine
+Lötlutsche dabei.
+
+Wenn Ihr nicht gleich einen Lötkolben kaufen wollt, könnt Ihr ihn bestimmt in
+einem [Hackerspace](http://hackerspaces.org) in Eurer Nähe ausleihen, um den
+PBG zu bauen.
+
+TODO: kann wer was zum Zinn schreiben?
+
+TODO: Da man bei den ganzen Sachen hier immer wieder was besorgen muss sollten
+wir auch Tips zum besorgen der Werkzeuge und Elemente geben. 
+
+### Auswahl des Multimeters
+
+Das Multimeter ist ein Werkzeug mit dem man verschiedene (deswegen "multi")
+elektrische Messgrößen erfassen (d.h. messen, deswegen
+["meter"](http://de.wikipedia.org/wiki/Meter)) kann.
+
+Für den Pentabug reicht ein ganz billiges aus dem Baumarkt oder halt auch von
+[Amazon](http://www.amazon.de/dp/B003IP80SS/).
+
+## Auf gehts
+
+Jetzt geht es schon ans Zusammenbauen des Pentabugs. Wenn Du kein Bock auf
+lesen hast, haben wir dafür auch ein
+[Video](http://c3d2.de/news/video-pentabug-bauen.html) vorbereitet, was gut
+erklärt, wie der Pentabug gelötet wird.
+
+Während Du jetzt also das Lichtschwert eines jeden Junghackers, also den
+Lötkolben an der Steckdose heiß werden lässt, packe die einzelnen Bauteile des
+Pentabug vor Dir aus und schaue sie genau an. Am besten sortierst Du sie, damit
+Du sie schnell griffbereit hast.
+
+In der PBG-Kiste ist auch ein Zettel, der die nötigsten Informationen
+zusammenfasst. Bei einigen Bauteilen muss man aufpassen, in welcher Richtung
+man sie einbaut.
+
+Die Bauteile werden in der Reihenfolge verbaut, in der sie auf dem Zettel
+stehen. Das macht man deswegen, weil man später an manche Bauteile nicht mehr
+so gut rankommt, wenn rundherum schon viele andere Teile verbaut sind.
+
+Das Basis-Bauelement, auf dem alle anderen Teile verbaut werden, ist die
+Platine.
+
+### Wie man richtig lötet
+
+
+
+[Disclaimer]: Auch andere Läden haben Lötkolben oder andere Werkzeuge / Bauelementeund die von uns angegebenen Links sind keinesfalls die besten oder billigsten Teile. Die Links sollen Euch lediglich in die ungefähre Richtung schicken.