Mehrsprachige Quellcode Documentation - Ob & Wie?

[Perlsau]

Zitat von Phoenix:

Ein Software-Entwickler sollte daher des Englischen mindestens readonly ausreichend mächtig sein.

Ganz genau, sehe ich auch so: Wenn man schon programmieren will, dann sollte man sich auch die Mühe machen, seine Englischkenntnisse zu verbessern. Ich mache das seit Jahren regelmäßig, so daß ich zumindest einigermaßen gut lesen kann, was in englisch geschrieben steht. Beim gesprochenen Wort hapert es bei mir gewaltig, das liegt wohl am fehlenden Umgang mit englischsprachigen Menschen: Bestimmte Dialekte, insbesondere amerikanische, verstehe ich nur sehr schlecht, und meine Aussprache ist u.a.S. Aber schon damals in den frühen Neunzigern, als ich mit Turbo Pascal begann, erleichterten mir meine Englischkenntnisse den Zugang enorm, sind doch die ausnahmslos in Englisch verfügbaren Befehle, wenn man einmal von allzu kryptischen Bezeichnern absieht, beinahe intuitiv verständlich, wenn man über Grundkenntnisse der englischen Sprache verfügt.

[Dejan Vu]

Also dogmatisch zu verlangen, das Dokumentation immer in Englisch zu erfolgen hat, ist vielleicht etwas kurzsichtig gedacht.

Ich habe für eine deutsche Firma gearbeitet, die Steuerungsprogramme erstellt, die nur dieses Team von Programmierern betreut. Wozu zum Deibel sollten die die Doku in Englisch erstellen, wo doch die wenigsten der Programmierer dieser Sprache so mächtig sind, das sie zusammenhängende Sätze in englisch formulieren können? Deutsch kann jeder, also sind nicht nur Dokumentation, sondern auch sämtliche Bezeichner in Deutsch. Alles andere wäre kreuzdämlich. Natürlich, falls mal ein Schwabe zu den Jungs stößt, hat er ein Problem.

Derzeit besteht das Team (einer anderen Firma) aus 10 Entwicklern aus 6 Ländern, die eine Legacy Software neu schreibt. Die alte Software enthielt portugiesische Kommentare, portugiesische Bezeichner usw. Natürlich wird *diese* Software in englisch (Quatsch, in C#) geschrieben und dokumentiert.

Es kommt also (wie) immer auf den Kontext an.

[Mavarik]

Zitat von Dejan Vu:

Ich habe für eine deutsche Firma gearbeitet, die Steuerungsprogramme erstellt, die nur dieses Team von Programmierern betreut. Wozu zum Deibel sollten die die Doku in Englisch erstellen, wo doch die wenigsten der Programmierer dieser Sprache so mächtig sind, das sie zusammenhängende Sätze in englisch formulieren können? Deutsch kann jeder, also sind nicht nur Dokumentation, sondern auch sämtliche Bezeichner in Deutsch. Alles andere wäre kreuzdämlich. Natürlich, falls mal ein Schwabe zu den Jungs stößt, hat er ein Problem.

...

Es kommt also (wie) immer auf den Kontext an.

Stimmt der Kontext... War der nicht vorgegeben?

Zitat von Mavarik:

Hierbei geht es nicht darum eigene Projekte zu dokumentieren, sondern um eine Sourcecode-Sammlung für andere Developer.

[DeddyH]

Nö, war er nicht. Geht es um rein deutsch(sprachig)e Developer, oder können die auch irgendwo am Himalaya sitzen? 42!

[Sir Rufo]

Zitat von DeddyH:

Nö, war er nicht. Geht es um rein deutsch(sprachig)e Developer, oder können die auch irgendwo am Himalaya sitzen? 42!

"andere Developer" war nicht eingeschränkt, somit könnten die sogar auf dem Titan sitzen

[Dejan Vu]

Lieber ordentlich in einer Sprache dokumentieren, die man beherrscht, als linkisch, schwer verständlich und teilweise falsch in einer Sprache, die man nicht versteht.

Mein Lieblingsbeispiel war der 'durchlaufende Posten', der von einem Programmierer als 'running Post' betitelt wurde. Ziemlich lustig.

Die Softwaresammlung der Steuerungsprogrammierer (die, die alles in Deutsch gemacht haben), war übrigens für andere Entwickler.