Allerdings zielt eine solche Doku oder ein Handbuch ja auf einen Enduser ab, der sich nicht mit dem ganzen Thema auskennt.
Sicher - deswegen ist in dem Gliederungsvorschlag, den ich dir geschickt habe, Installation und Vorwort nur ein Punkt. Da kann man dann die Installationsanleitungen verlinken und darauf hinweisen, dass man die dBoxen mit Neutrino bei eBay bekommen kann. Außerdem ist der "Schwierigkeitsgrad" von Kapitel zu Kapitel steigend (oder zumindest war das meine Absicht...
).
Oder wie in meinem Fall, wenn die Box jemand benutzt wie mein Vater, der keine Ahnung von den Details hat und sich damit auch nicht beschäftigen kann. Hier setzt das Handbuch genau an der richtigen Stelle an.
Ja, aber ich finde, man sollte auch die "Experten-Funktionen" so verständlich wie möglich dokumentieren. Otto Normalzapper muss diese Kapitel ja nicht unbedingt lesen...
Das ganze Online als Open Source zu führen ist für mich kein Problem. Ich mach das ja nicht aus kommerz-Gedanken, sondern um meinen Beitrag zu diesem Projekt zu leisten.
Sehr schön.
(Wobei "Open Source" nicht ganz die richtige Bezeichnung ist, weil z.B. HTML ja eh Quelltext ist. Aber ich glaube, es wurde richtig verstanden, was ich gemeint habe... "Public Domain" oder etwas GPDL-ähnliches würde es wohl eher treffen...)
Die Doku würde ich dann in mehrerern Versionen immer in einzelnen Versionsschritten ausliefern, wobei die Versionsnummer der Doku dann am besten immer der der aktuellen Image Version enspricht. (Yadi!?) Das hält das ganze übersichtlich.
Klingt sehr gut! Wobei ich bezweifle, dass du auf Dauer mit der Snapshot-Frequenz mitkommst, und die Releases z.T. (zu?) lange auf sich warten lassen...
Ein anderes Problem ist natürlich, dass es noch andere Images gibt, z.B. JtG. Aber an irgendwas muss man sich ja orientieren, und ich denke, dass 1. Yadi das verbreitetste ist und 2. die Unterschiede nicht so gewaltig sind, dass ein JtG-User mit der "Yadi-Neutrino"-Doku komplett im Regen stehen würde.
Als Formate dachte ich an folgende: (...)
Ist ja wirklich toll, aber wird das nicht auf Dauer lästig? Ich finde, HTML sollte reichen (am besten möglichst simpel mit CSS, dann können es Seiten wie dboxupdate problemlos integrieren). Den Rest kann man dann wahrscheinlich immer noch irgendwie generieren.
Aber einen Zentralen Punkt der das Handbuch dann jeweils mit Neuerungen ergänzt empfinde ich schon als wichtig, ganz einfach um einen Stil durchgängig in der Doku zu haben.
Jepp, sehe ich auch so. Mir ging's nur darum, dass dieser "zentrale Punkt" eben nicht zwangsläufig dauerhaft bei dir liegt, damit es eben auch weiter gehen kann, wenn du irgendwann mal die Änderungen nicht mehr einpflegen willst oder kannst.
Wo ich allerdings noch Klärungsbedarf sehe sind die Unterschiede zwischen den Boxen.
AFAIK gibt es nur verschiedene Layouts der Fernbedienung und der Box selbst (Anschlüsse, Slots, Display-Position), alles andere ist (bis auf sporadische Bugs und den 1x/2x-Unterschied beim Flashen) identisch.
