Mehrsprachige Quellcode Documentation - Ob & Wie?

[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.