RE: [DOC-DE] Version der PHP-Doku

Hallo zusammen, On Sun, 2003-10-26 at 17:23, Sebastian Picklum wrote: > 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. > Mein Senf ... Eine solche "Auflagenummer" wuerde ihren Zweck nicht erfuellen bzw. sinnlos sein. Man koennte aus ihr nicht erkennen, welche Teile (neu) uebersetzt worden sind, was es fuer signifikante Aenderungen gegeben hat etc. Was nuetzt eine solche immerzu inkrementierte Nummer, wenn sie keinen Wert hat. Dazu muesste man zur betreffenden # immer sowas wie eine Changelog mitliefern. Ich pers. schaue genauso wie Sebastian auf das Datum der Generierung bzw. wenn ich eine moeglichst aktuelle Version haben will, lese ich die englische Version. Und Christian, zur PHP-Version laesst sich nur soviel sagen, dass vermerkt ist welche Funktionen in welchem major-release vorhanden sind. Dazu kommen noch spezielle Bemerkungen fuer sub-releases. Und warum sollte man nicht einfach ein update auf die neueste stable machen? Die alten Funktionen verliert man meisst nicht, und die neuen features sollten dich nicht stoeren. Gruss, Ali > 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 > > > > ---- > > -- > PHP German Documentation Mailing List (http://php.net/manual/de/) > To unsubscribe, visit: http://www.php.net/unsub.php