misanthropy schrieb am 6. Dezember 2011 02:09
Meiner persönlichen Meinung nach kann jemand noch so toll und
brilliant sein, wenn sein Code scheiße zu lesen ist, schlecht
strukturiert und am besten undokumentiert, so ist diese Person
nicht tragbar in einem Team.
Da stimme ich Dir fast zu 100% zu - mit einer klitzekleinen Ausnahme: Ob Code dokumentiert ist oder nicht sagt nicht wirklich was über die Qualität aus.
Ich habe durchaus schon undokumentierten aber exzellenten Code
gesehen - der braucht dann auch keine Dokumentation, weil sich beim Durchlesen des Codes direkt alles Wesentliche erschließt.
Und am anderen Ende des Spektrums dann natürlich auch jede Menge unsägliches Gewurstel, das - streng nach Richtlinie - hervorragend "dokumentiert" ist. Nur hilft so bei so einem Quark wie
int foo = frobnicate(bar); // foo is now frobnicated by bar
die "Dokumentation" halt auch nicht viel weiter :-/