Software und ihre Dokumentation

[Kai345]

[latex]Mae  govannen![/latex]

Nebenbei bemerkt: Apache und mySQL kommen auch ohne Doku, dafür sind die Online-Handbücher prima. Selbst Clientsoftware wie Firefox wird ohne Doku installiert. Die muss man sich gar mühsam aus -zig Quellen zusammensuchen, weil sie nicht einmal an zentraler Stelle gepflegt wird.

ja, das ist wirklich zum Kotzen. Ich habe inzwischen mehrere ältere Programme, die nicht mehr weiterentwickelt wurden und deren Websites nicht mehr existieren und/oder von denen ich ältere Versionen genutzt hatte. Hätte ich jetzt eine Offline-Doku, müßte ich nicht immer alles ausprobieren oder und erraten bzw. hätte eine zu meiner Version passende Doku.

Bei PHP kann ich seit einiger Zeit nicht mehr direkt aus dem Editor die Doku zu einer Funktion unter dem Cursor aufrufen[1], wenn diese Unterstriche enthält[2], weil die vom Editor erzeugten URL inzwischen nicht mehr angenommen werden[3]. Oder Mozillas MDC: Da wird bei alten Links teilweise auf die Hauptseite umgeleitet statt auf den neuen Ort und man darf selber sehen, wie man die gewünschte Info findet (bzw. muß es in die Suche eingeben). Auch nicht so toll.

Ich *hasse* Online-Dokus.

Cü,

Kai

[1] bzw. mußte mir ein externes Script schreiben, das die Funktions-Namen umwandelt
[2] also gefühlte 2/3 der PHP-Funktionen
[3] Der Editor erzeugt URL wie z.B. http://php.net/manual/en/function.file_get_contents, also so wie die funktion auch benannt wird was aber seit einiger Zeit nicht mehr funktioniert, stattdessen muß es jetzt zwingend http://php.net/manual/en/function.file-get-contents[.php] (also mit Bindestrichen) heißen ....