RE: [DOC-DE] Version der PHP-Doku
| From: | Sebastian Picklum | Date: | Sun, 26 Oct 2003 16:23:58 +0000 |
| Subject: | RE: [DOC-DE] Version der PHP-Doku | ||
| References: | 1 | Groups: | php.doc.de |
| Request: | Send a blank email to doc-de+get-942@lists.php.net to get a copy of this message | ||
Hallo!
Ich persönlich mache den Stand der Doku anhand des Datums fest (bei der
Online-Version oben rechts im graunen Kasten).
Natürlich kann man auch soetwas wie eine Auflage-Nummer implementieren, aber
ich finde, dass man die Aktualität eher anhand eines Datums festmachen kann.
Any other opinions?
Zu den Namen: Warum haben wir eigentlich für jeden Namen eine eigene Zeile?
Können wir nicht - wie bei der PDF-Version - mehrere Namen pro Zeile
unterbringen. Das würde dann nur noch 20-25% des Platzes brauchen.
Viele Grüße
Sebastian Picklum
> -----Ursprüngliche Nachricht-----
> Von: Christian Helmbold [mailto:christian.helmbold@gmx.de]
> Gesendet: Mittwoch, 22. Oktober 2003 13:49
> An: doc-de@lists.php.net
> Betreff: [DOC-DE] Version der PHP-Doku
>
>
> 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
>
> --
> PHP German Documentation Mailing List
> (http://php.net/manual/de/) To unsubscribe, > visit:
> http://www.php.net/unsub.php
>