Re: Version der PHP-Doku
| From: | Friedhelm Betz | Date: | Sun, 26 Oct 2003 22:07:21 +0000 |
| Subject: | Re: Version der PHP-Doku | ||
| References: | 1 | Groups: | php.doc.de |
| Request: | Send a blank email to doc-de+get-952@lists.php.net to get a copy of this message | ||
On Wednesday 22 October 2003 13:49, Christian Helmbold wrote:
> 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.
Warum? Die Doku gilt fuer alle PHP-Versionen, Ali hat das relevante dazu
geäußert.
> Ü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? ;-)
Du würderst also eine Version des Manuals fuer jede PHP-Version vorschlagen?
Abgesehen davon, dass das ungefähr 80 % gleichen Inhalt bietet, wer soll das
machen? ;-)
Es gibt Ueberlegungen, Funktionen/Features die der installierten PHP-Version
nicht entsprechen, "auszublenden".
> 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.
Keineswegs neu der Vorschlag ;-) In kommenden Versionen des Handbuchs
(Livedocs) soll das kommen.
[...]
> 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!
Sehe ich genau so ;-)
> Ich hoffe, ich bin jetzt niemandem auf die Füsse getreten, ich möchte
> nur Anregungen zu Verbesserungen geben.
Nur zu ;-), die beste Hilfe ist natürlich übersetzen...
Gruesse
Friedhelm