Thomas Luethi: Englische vs. deutsche Dokumentationen

Beitrag lesen

Hallo,

Wenn jemand so mangelhafte Englischkenntnisse hat, wie ich, dann ist meist auf solchen Seiten die Information sehr dünn,

Gerade auf technischen Seiten wie dem PHP-Manual ist doch vieles sprachunabhaengig.
Die ganzen Code-Beispiele u.s.w. sind doch auch ohne Englischkenntnisse
weitgehend verstaendlich.

Wenn die deutsche Uebersetzung den gleichen Informationsgehalt hat und wenn
sie gleich aktuell ist wie das englische Original, dann verlinke ich natuerlich
auch darauf.

Aber bei der genannten Seite ist das anders.
Du wirst mit mir einig sein, dass
http://www.php.net/manual/en/reserved.variables.php#reserved.variables.get
auch _Dir_ mehr Infos bietet als:
http://www.php.net/manual/de/missing-stuff.php#reserved.variables.get
:-)

deshalb hielte ich es für besser, in einem solchen Fall auf den Defekt hinzuweisen und ev. eine Alternative anzugeben.

Gerade dieser kaputte Link wird hier regelmaessig gepostet.
Man tut den Newbies einen Baerendienst, wenn man sie auf
http://www.php.net/manual/de/language.variables.predefined.php
schickt.

Wenn ich auf diese Seiten (/en/) verweise, schreibe ich stets dazu,
dass die deutsche Uebersetzung unvollstaendig/veraltet ist.

Und auf "Sekundaerliteratur" statt auf das Original-Manual zu verweisen,
halte ich fuer problematisch.
Nur das englische Manual ist "verbindlich" und top-aktuell.
(Z.T. ist sogar schon Zeugs von PHP 5 drin...)

Eine Ausnahme ist die dclp-FAQ - auch die ist erfreulicherweise
ziemlich aktuell. Aber natuerlich keine vollstaendige Referenz.

---

Auch bei HTML- und CSS-Fragen verweise ich lieber auf die englischen
Originale beim W3C als z.B. auf die deutschen Uebersetzungen bei
http://www.edition-w3c.de/
Diese sind sprachlich schlecht (z.B. inkonsequente Verwendung von Begriffen),
und vor allem enthalten sie extrem aufdringliche Werbung fuer die Buecher
des Verlags. Dieser Punkt haelt mich am meisten davon ab, dorthin zu verlinken.

Und im "Vorspann" der Uebersetzung der HTML 4.01 Spezifikation
http://www.edition-w3.de/TR/1999/REC-html401-19991224/
steht z.B. so ein netter Satz wie:
"Kein Teil dieses Textes darf kopiert werden."
Huch, jetzt habe ich es trotzdem getan!
Hoffentlich kriege ich wegen dieses verbotenen Zitats keine Abmahnung...

Ich werde mich also hueten, hier auf diese edition-w3c Uebersetzungen
zu verweisen oder sie zu zitieren.

Gruesse,

Thomas