weneu hat geschrieben:
ich habe mich vor langer Zeit auch schon mal mit dem Gedanken getragen, so eine Art Handbuch für WSWIN zu schreiben.
Was hat mich dann davon abgehalten?
- Es ist fast unmöglich, ein Handbuch sowohl für den absoluten Anfänger als auch für den fortgeschrittenen Anwender zu schreiben. (man bedenke den Umfang desselben)
Deshalb mein Vorschlag, es mit UDO zu machen. Die hierarchische Struktur ist ideal dafür, in den oberen Ebenen dem erfahrenen Anwender die Stichpunkte zu liefern und in den unteren in die feinen Details und Anfängerfragen zu gehen.
- dazu kommt, dass in der WSWIN-Hilfe (bei allen Problemen, die sie auch mit sich bringt), im Prinzip unheimlich viel enthalten ist.
Es ist so gut wie alles enthalten, aber teilweise einfach schwer zu finden. Deshalb sollte IMHO diese Hilfe auch die Basis für ein "neues" Handbuch sein.
Das ständige Fortführen der Hilfedatei dürfte Werner bestimmt nahezu soviel Arbeit kosten wie die reine Programmierarbeit.
Davon gehe ich ganz fest aus, und deshalb habe ich kein Problem damit, einen Programmierer bei den Punkten zu unterstützen, bei denen ich es kann. Die "Bezahlung" von WsWin sehe ich in keiner Weise als Lohn für den Programmierer an. Dafür ist sie viel zu gering. Auch Werner hätte einen Vorteil davon, wenn andere die Dokumentation pflegen. Er müßte nur noch die Beschreibung neuer Funktionen abliefern, den Einbau in die Doku in allen Varianten übernehmen andere.
Was ich oben bei der Beschreibung von UDO vergessen habe: UDO ermöglicht includes, also kleine Teilmodule, aus denen die Gesamtdokumente erzeugt werden. Es ist also dafür prädestiniert, daß kleine (notfalls Einmann-)Teams einzelne Themen bearbeiten und pflegen und auch kleine Änderungen schnell in das Gesamtdokument übernommen werden können.
Daraus habe ich dann eben die Konsequenz gezogen und mich darauf beschränkt, keine "Bedienungsanleitung" für WSWIN zu erstellen, sondern habe als erstes die Seite
http://www.wernerneudeck.de/wetter/faq/index.html
erstellt.
Sie sollten Usern, die grundlegend mit WSWIN vertraut sind, die Möglichkeit geben, etwas weiterführend damit zu arbeiten.
Diese Seiten sind ebenfalls extrem hilfreich und sollten auf jeden Fall (mit deiner Zustimmung natürlich) in einer umfassenden Doku enthalten sein.
Dann trat eines Tages Erich Lebeth an mich heran mit dem Gedanken, diese vielen einzelnen Hilfeseiten doch in einem "Buch" zusammenzustellen und hat sich auch bereit erklärt, die Zusammenstellung zu übernehmen.
Dabei herausgekommen ist dann
http://www.wernerneudeck.de/wetter/faq/praxis.pdf
ein Buch, das immerhin über 110 Seiten umfasst.
Wer will, kann sich mal Gedanken darüber machen, welcher Zeitaufwand darin steckt.
Nein, möchte ich nicht
Und damit komme ich jetzt wieder auf den Ausgangspunkt der Frage zurück:
Ein Handbuch für WSWIN
... halte ich auch aus genau den Gründen, die du unten anführst, für wenig sinnvoll. Eine in Teamarbeit wachsende Dokumentation aber, die es ermöglicht
- * Werner die eigene Arbeit an der WsWin-Hilfe zu einem Teil abzunehmen
* eine HTML-Hilfe zu erzeugen, die online und lokal auf dem Userrechner verfügbar ist
* ein RTF-Dokument auszugeben, das in Word oder OpenOffice (oder sonst einen vernünftigen Wordprocessor) eingelesen werden kann
* und aus diesem Wordprocessor heraus natürlich als PDF ausgegeben werden kann
halte ich dagegen für realisierbar und sinnvoll.
Selbst wenn man die WSWIN-Hilfe dazu heranzieht (und da hat ja auch Werner noch ein Wörtchen mitzureden),
Och, ich glaube, mit dem Angebot, ihm künftig bei Änderungen den fertig strukturierten und formatierten Sourcecode für die Hilfe (oder die fertige Hilfe, wenn jemand aus dem Team den Compiler hat) zu liefern, kann man ihn durchaus kitzeln
wäre es schon ein monströses Unterfangen, das einen nicht unerheblichen Zeitaufwand bedeuten würde.
Viel (zuviel) für einen einzelnen. Für drei bis fünf Leute wäre der Aufwand überschaubar.
Und dazu kommt, dass WSWIN ja ständig weiterentwickelt wird, das Buch also nie auf Höhe der Zeit sein könnte.
Ein verlegtes Buch aus Papier sicher nicht, auch nicht mit meinem Vorschlag. Bei einem RTF oder PDF, das sich jeder selbst (in Auszügen) ausdrucken kann, ist das (Werners Unterstützung vorausgesetzt) durchaus möglich.
Bin gespannt, wie andere User sich dazu äußern, auch wenn wir jetzt vom Thema dieses threads sehr stark abweichen.
Och, das bißchen...
Allein würde ich den Job nicht zu stemmen versuchen. Aber wenn noch mindestens zwei andere mit einsteigen, sehe ich eine realisierbare Möglichkeit. Die Syntax von UDO ist leicht verständlich, die Ausgaben haben mich schon vor Jahren überzeugt. Die für Teamarbeit nötige Infrastruktur existiert. Entweder würde Werner hier eine geschlossene Gruppe einrichten, oder ich mache es in
http://www.hollenbergs.de/phpBB2/ (das ist ein "richtiger" Server und nicht so lahm wie mein privater). Und ein Verzeichnis, auf das zugelassene Benutzer per FTP zugreifen können, ist auch schnell eingerichtet.
Also, wer schreit "
HIER"?
