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, 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 Strucktur des Quellcodes so sinvoll?

Diejenigen, die nichts zu dokumentieren haben, sollten dann denjenigen, wie z.B. den Peter helfen, 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 muss

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

• Borg 3D
  • Ansteuerungsprinzip
  • Tutorial wie man Animationen schreibt
  • src Dokumentation
  • Nachbauanleitung.
• 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?

.....