Veranstaltung/D-Day

Facts

• Was: Documentation-day
• Agenda: Generate better reading experiences

An diesem Termin soll sich jeder, der etwas für das Labor gebaut oder programmiert hat, die Zeit nehmen, um es zu dokumentieren. Deswegen sollte er folgende Fragestellungen für sich beantworten:

• Welche Informationen, Bilder kann ein Außenstehender auf der das-labor.org Seite finden.
• Welche Informationen brauchen andere LABOR Mitglieder um es zu benutzen, warten oder weiter zu entwickeln.
• Sind wichtige Stellen im Source-Code, wie Schnittstellen, dokumentiert bzw verständlich.
• Soll das Projekt zukünfitg unter der GPL laufen?
• Ist die Struktur des Quellcodes so sinnvoll?

Diejenigen, die nichts zu dokumentieren haben, sollten dann denjenigen (wie z.B. dem Peter), die unheimlich viel zu dokumentieren haben, helfen. Und bereits bestehende Dokumentation nach Rechtschreibfehlern, schlechten Formulierungen oder Vollständigkeit durchsuchen und anschließend verbessern.

Was alles dokumentiert werden sollte

Folgende Punkte sollten dokumentiert werden: ()

• Borg 3D (Martin)
  • Ansteuerungsprinzip
  • Tutorial wie man Animationen schreibt
  • src Dokumentation
  • Nachbauanleitung
  • Blinkenprojects Wikieintrag
• Roulette
• Optimierung der Wiki-Struktur
• Andre´s Borg
• CAN
  • Steckerbelegungen, Verkabelung, Protokoll
• Funksteurung
  • Wie funktioniert es.
  • Was ist zu beachten.
• Styporschneider und Desinger
  • Bedienungsanleitung für Schüler(Martin)
• Lasershow
• Leuchstoff Fnordlicht
• Wie bediene ich MPD
• Warum haben wir soviele Subnetze?
• Mit IPSec sicher durchs WLAN
• Wie telefoniere ich übers Internet kostenlos mit dem Labor? - Jörn (Doku fast fertig)
• Wie benutze/reinige ich die Shisha? - Daniel