Online-Dokumentation

Es hat mich ja schon lange genervt dass viele Programme/Sprachen/Framesets oder ähnliches nur Online-Dokumentationen anbieten aber in letzter Zeit wird das immer schlimmer (Das liegt sicher auch zum großen Teil daran, dass ich noch immer kein permanentes Internet in Dresden habe.)

Es ist einfach grauenvoll wenn man gerade mal wieder 3 Stunden in einer Bahn sitzt, das Notebook in der Tasche und eigentlich viel Zeit zum Arbeiten hätte. Leider hängt man nach 5min an einem kleinen Detail das man in Sekunden in der Doku finden würde, doch die Doku hat man natürlich mal wieder nicht mit.

Ich sehe es ja noch ein dass für viele Frameworks und Bibliotheken Bücher als Medium einfach zu langsam sind. Wenn sich alle 3-4 Monate ein neues Framework als Hype breitmacht oder komplett umgeschrieben wird, wie soll sich dann jemand hinsetzen und nebenbei auch noch ein Buch dazu schreiben? Von den armen Entwicklern die sich all die Bücher kaufen sollen dann mal ganz abgesehen. In dieser Beziehung musste ich neulich auch erst wieder feststellen wie verwöhnt ich bin. Plötzlich musste ich meine Bibliotheksgewohnheiten von einer vollen Etage voller IT-Bezogener Bücher (Bibliothek der WHZ) auf ein bis zwei Regale pro Zweigstelle (Stadtbibliotheken Dresden, die sind an sich schon ziemlich gut ausgestattet aber halt keine Fachbibliotheken) umstellen. Natürlich findet man dann eher seltener etwas zu neueren oder ausgefallenen Themenbereichen wie Python mit AppEngine.

Es sollte jedenfalls möglich sein die überall vorhandenen Online-Dokumentationen nicht nur Online lesen könnte sondern auch in irgendeiner statisch zusammengestellten Form runterladen könnte. Nicht in jeder Situation muss man permanent die aktuellste Version von vor einer halben Stunde im Wiki nachlesen, manchmal würde es auch die 6 Monate alte Version im PDF-Format oder noch besser als Tarball mit HTML-Seiten tun.

Manche Projekte verhalten sich bei diesen Dingen auch durchaus wie gewünscht, die Dokumentation zum Zend Framework gibt es z.B. jederzeit gut sichtbar zum Download, das gleiche gilt ebenfalls für CakePHP oder (als wohl bekanntestes Beispiel) für SelfHTML.

Andere Projekte scheinen das noch immer nicht verstanden zu haben. Ich würde mich z.B. für einen möglichen Job der demnächst anstehen könnte gerne schonmal ins Symfony Framework einlesen, die Online-Doku scheint auch recht umfangreich und hilfreich, leider gibt es keine wirklich praktikable Möglichkeit (vom Download jeder einzelnen Seite mal abgesehen) um das Ganze auf einen USB-Stick zu ziehen und mitzunehmen. Ach  halt... ich könnte natürlich das offizelle Buch ($29,10) dazu bestellen oder zu einem Workshop (1200€, in Frankreich) gehen, beides sehr deutlich auf der Seite angeboten. Trotz Doku unter GFDL ist man also ziemlich eingeschränkt, ein Schelm wer böses dabei denkt.