Thomas Luethi: Englische vs. deutsche Dokumentationen

Beitrag lesen

Hallo,

Gerade diese Seite hat mir schon mehrmals bei Problemen geholfen, wobei ich dazu sagen muss, daß ich, wenn ich auf einen kaputten Link stoße, auch das englische Pedant zu Rate ziehe.

_Du_ weisst, dass es normalerweise reicht, das /de/ in der URL durch /en/ auszutauschen.
Aber Newbies wissen das nicht. Deshalb sollte man sie IMHO nicht hierhin schicken:
http://www.php.net/manual/de/language.variables.predefined.php
Diese Seite ist  tueckisch, weil nur die "erste Haelfte" uebersetzt ist,
d.h. alle Links (zu $_GET u.s.w.) zeigen auf eine "Fehlendes" Seite,
anstatt auf die englische Seite.

Nur das englische Manual ist "verbindlich" und top-aktuell.
(Z.T. ist sogar schon Zeugs von PHP 5 drin...)
Naja, das mag für einen Profi wie dir relevant sein, aber für mich, der grade mal am Lack kratzt, ist eine verständliche, deutsche Erklärung eine unersetzbare Hilfe.

Das PHP5 Zeugs in der Doku nervt mich eher, als dass es mir nuetzt.
Da denke ich z.B. bei str_ireplace()
http://www.php.net/manual/de/function.str-ireplace.php
"Ah, toll, genau diese Funktion haette es schon laengst geben muessen!"
Wenn ich dann genau hingucke, sehe ich, dass die erst in PHP 5
vorgesehen ist ("PHP 5 CVS only"). Das ist dann frustrierend.

Ein weiteres Beispiel, wo die deutsche Doku stark hinten nachhinkt:
http://www.php.net/manual/de/function.getimagesize.php
nennt gerade mal 4 Typen (GIF, JPG, PNG, SWF), dabei kann
die Funktion mittlerweile deren 16:
http://www.php.net/manual/en/function.getimagesize.php
Und das ist bei Fragen wie "Wie kann ich herausfinden, was
eine (hochgeladene) Datei fuer ein Dateityp ist, ohne mich auf
die Endigung oder die Browser-Angaben zu verlassen" eben
schon wichtig.

Wie gesagt, ich lese (dank genuegenden Englischkenntnissen) meist
die englische Doku. Wenn ich hier eine URL poste, schaue ich meist,
ob die deutsche Seite gleich aktuell ist, wie die englische, und
entscheide dann, welchen Link ich poste.

Gruesse,

Thomas