af0815 hat geschrieben:marcov hat geschrieben:Das ist das ganze Problem mit solche wiki Loesungen. Es kontrolieren und koordinieren ist sehr schwierig. Kann man einfach an dem heutigen Wiki (und wiki Dokumentationen anderen Projekten) absehen.
Wobei man für die Dokumentation sicherlich die Wiki heranziehen kann, wenn man das Strukturiert.
Mann konnte sicher ein Wiki nutzen. Aber ich denk das ein publiker Wiki
- Wie branched man ein Wiki (mehrere versionen)
- Wie macht man ein Wiki fuer offline nutzer zugaenglich?
- Wie stellt man sicher das es rund ein Release keine disruptieve aktivitaeten gibt.
- (wenn offen) wie stellt mann sicher das die globale Struktur intakt bleibt (so das nicht ganze stuecken)
- (wenn offen) adminstrations overhead. Die konstante Probleme mit spammer, captcha's usw.
- (wenn offen) auch administrations overhead fuer development. zb den heutigen Wiki kann nicht mehr einfach nach ein offline format exportiert werden weil das Tool (und das gibts!) dafuer durch wiki antispam packages nicht mehr Funktioniert. Das heist auch das alle Tools die mit der wiki kommunizieren nicht often sein koennen. (weil sie auf den Server funktionieren.
Aber wichtigsten: Das alles benoetigt eine ganze menge muehe, die nicht in Administration gesteckt werden sollte, aber in schreiben von Dokumentation. Man bekommt kein Dokumentations mitglieder, aber Dokumentation herder.
Einen halb geschlossen wiki wuerde besser sein, aber ich denke das das noch immer mehr kompliziert dan das es structurierter Dokumentation einfacher macht. Wiki ist gut fuer unstrukturierter Notitzen usw, und kann Input fuer die wirkliche Dokumentation sein, aber meiner Meinung nach, nicht mehr dan dass.
Programmer moegen gern administration machen (anfangs allerdings), und noch lieber da etwas fuer schreiben, aber keiner will tatsaechlich Dokumentation schreiben. Darum gibts es immer endlose Diskussionen uber wie das Hilfe system auf zu setzen.
Mann kann sich aber sprichwortlich hinsetzen mit einen einfachen texteditor, als Key den Dialoognamen nemen, und dann hilfe schreiben in eine einfache fpdoc oder wiki aehnliche tag Sprache. Wenn mann davon genug hat, kann es immer innerhalb einer Stunde konvertiert werden nach welch hilfe format gewaehlt wirt.
Umgekhert kann die Struktur dann in die Wiki reexportiert werden. Was der Wiki am meisten fehlt ist eine Struktur die die Teile besser querverlinkt, bzw. wie zB. ein Buch strukturiert.
Administration, ein Tooling das an komplizierte Paketten wie Mediawiki anhaengt (alle Kustomizierten 3rd party packages die in FPC und Lazarus genutzt sind frueher oder Spaeter ein Problem. (Mantis, wiki, FPC's netscape community server use)). Und Kustomizierung werde noetig fuer solche Dokumentation import/export/indexierung usw.