Veranstaltung/D-Day: Unterschied zwischen den Versionen

Aus LaborWiki
Wechseln zu: Navigation, Suche
Zeile 6: Zeile 6:
* Agenda: Generate better reading experiences
* 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:
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, 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.
*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.
*Sind wichtige Stellen im Source-Code, wie Schnittstellen, dokumentiert bzw verständlich.
*Soll das Projekt zukünfitg unter der GPL laufen?
*Soll das Projekt zukünfitg unter der GPL laufen?
*Ist die Strucktur des Quellcodes so sinvoll?
*Ist die Struktur des Quellcodes so sinnvoll?


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.
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=
=Was alles dokumentiert werden sollte=

Version vom 5. Februar 2006, 17:47 Uhr

Facts

BorgScreenshot.jpg
  • 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?

.....