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

Ich denke wir sollten hier im voraus schon einmal wichtige Sachen sammeln:

• Borg 3D
  • Ansteuerungsprinzip
  • Tutorial wie man Animationen schreibt
  • src Dokumentation
  • Nachbauanleitung.
• Roulette
• Optimierung der Wiki-Struktur
• AndreBorg
• CAN
  • Steckerbelegungen, Verkabelung, Protokoll
• Funksteurung
  • Wie funktioniert es.
  • Was ist zu beachten.
  • Welche Punkte
• Styporschneider und Desinger
• Lasershow
• Leuchstoff Fnordlicht
• Wie bediene ich MPD
• Warum haben wir soviele Subnetze?
• Wie telefoniere ich übers Internet kostenlos mit dem Labor? - Jörn (Doku fast fertig)

.....