Version der PHP-Doku
| From: | Christian Helmbold | Date: | Wed, 22 Oct 2003 11:49:22 +0000 |
| Subject: | Version der PHP-Doku | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-941@lists.php.net to get a copy of this message | ||
Hallo,
ich weiss nicht, ob das der richtige Ort für meine Vorschläge ist, aber ein besserer ist mir nicht eingefallen.
Ich finde es gerade zu unglaublich, dass die Doku keine Versionsnummer trägt (oder sie ist verdammt gut versteckt). Diese Selbstverständlichkeit sollte auch schleunigst bei PHP einzug erhalten.
Überhaupt scheint davon ausgegangen zu werden, dass immer die neueste PHP-Version eingesetzt wird und man nur dazu eine Doku braucht. Warum werden keine alten Versionen angeboten (außer der einen uralten)? Liegt das vielleicht daran, dass die Versionen mangels Nummer niemand unterscheiden kann? ;-)
Außerdem wäre bei dem gewachsenen Funktionsumfang vielleicht eine andere Struktur eine Überlegung wert. Man könnte z.B. eine Kategorie für DB-Funktionen, eine für Netzwerkfunktionen usw. machen.
Vorbildlich finde ich die Java-Doku.
Letzter und heikelster Punkt: die Nennung der Mitarbeiter. Ich weiss, dass Anerkennung so ziemlich der einzige Lohn ist, den die Macher der Doku bekommen. Trotzdem stört die Stelle, wo sie sich verewigen. Man muss jedesmal wenn man die Doku braucht über eine Bildschirmseite Namen wegscrollen. Das ist lästig!
Ich hoffe, ich bin jetzt niemandem auf die Füsse getreten, ich möchte nur Anregungen zu Verbesserungen geben.
Christian