mal sehen was er zauber und was nicht
vielleicht sollte man einfach 2gleisig fahren. ein handbuch und ein wiki. welches die gleichen textschnipsel verwendet.
ich finde handbücher generell besser zu lesen als ein wiki auch auf einem bildschirm!
Naja, Entwickler brauchen ihre eigene Doku ja nicht ubbedingt selbst zu lesen, egal ob im Wiki oder Bildschirm. Es geht ja um die Nutzer, die die Doku lesen müssen.
Ich gebe nochmal mein "Abschluss"-Statement zum sinkenden Schiff Wiki ab.
Mein wichtigstes Argument für ein Dokumentieren in einem Wiki ist, dass es eine recht unkomplizierte Autorenumgebung für erfahrende yaVDR-User bietet, die etwas festhalten wollen. Jemand, der Schreiberfahrung hat und der etwas an Doku beitragen will, kann beim Wiki schnell etwas "droppen" und muss keinerlei Software lokal installieren und sich nicht mit Versionierungssystemen auseinandersetzen.
Insofern erscheint mir der Kompromiss überflüssig, die Doku im Nachhinein in das Wiki zu importieren, weil das Wiki dann nur noch als Präsentationsmedium und nicht als Autorenumgebung genutzt wird. Der Aufwand lohnt dann nicht. Es gilt auch die Verdoppelung von Doku an verschiedenen Orten zu vermeiden (abgesehen von Übersetzungen).
Wichtiger als jede Technologie ist aber, dass überhaupt jemand etwas schreibt. Hier ist seahawk ja momentan ein leuchtendes Vorbild. Meine geheime Hoffnung war und ist, dass ein frisches (=leeres) Wiki mit modernem Erscheinungsbild und modernen Extensions eine Reihe von Leuten motivieren würde, sich dort zu beteiligen und zu dokumentieren.
Wenn nun seahawk - meinen Tagträumen entsprechend - das leere Wiki mit attraktivem Inhalt füllen gewollt hätte, war meine Hoffnung, dass er damit andere motiviert, mitanzupacken - mich inklusive: Ich habe mich ja seit 2009 dreißig Stunden mit Mediawiki und den Semantik-Sachen auseinandergesetzt, habe aber seit März eigentlich nur noch yaVDR-Doku im VDR-Wiki geschrieben und nicht mehr am yaVDR-Wiki weitergemacht, weil bisher alle meine Versuche, langfristig motivierte Autoren zu finden, gescheitert sind.
Nun haben wir aber mit seahawk momentan jemanden, der anscheinend nicht von außen motiviert zu werden braucht (hoffentlich hält das lange an! 
), der sich aber in der Autorenumgebung Wiki nicht wohlfühlt. Also soll er es halt in Asciidoc machen und dafür sorgen, dass eine möglichst unkomplizierte Möglichkeit existiert, an der Doku mitzuarbeiten - sprich Asciidoc-Quelltext ins yaVDR-Git, Autoren schicken dann Pull-Requests an den Maintainer. Damit wird aber die Hemmschwelle, an der Doku mitzarbeiten, für viele Community-Mitglieder erhöht. So sei es dann.
Inhaltlich wäre auch folgende Splittung der Doku denkbar:
Diejenigen Kapitel der Doku, die nur teamnahe Entwickler schreiben können, kommen in Asciidoc.
Dienjenigen Teile der Doku, die auf User-Erfahrungen und User-Hardware basieren, kommen in das leere Wiki (also Hardware-Datenbank, VDR-Bauvorschläge, etc.). Und dann verlinkt man sich gegenseitig.
Aber: Weil sich bisher eh keiner für die Semantik-Geschichten interessiert hat außer mir, ist das dann mein nächster Wunschtraum, der unerfüllt bleibt.
Und nun: Ich wünsche gutes Gelingen mit Asciidoc und Git!
Gruß
hepi