@ BlueCobold:
Würdest du mir vom Kommentieren abraten? Ich nehme nicht an, dass ich von Anfang an den perfekten Code schreiben werde und dieser somit Selbsterkärend sein wird.
Mfg
Jein. Wie TrommlBomml indirekt schon sagt, zwingt Dich das dazu saubereren Code zu schreiben, der besser verständlich ist. Das hat aber gerade für einen Anfänger das Problem, dass er irgendwann durch seinen naturgemäß ja doch noch relativ schlechten Code selber nicht mehr durch steigt. Spätestens da wäre ein Kommentar natürlich doch hilfreich. Das Ziel von gutem Code ist aber letztendlich, dass er ohne Kommentare auskommt.
Vor allem sollte aber man nicht anfangen Code zu kommentieren nach Schema-Dummy:
|
C-/C++-Quelltext
|
1
2
3
4
5
6
|
// Liste initialisieren
List<foo> bar = new List<foo>();
// Liste füllen
bar.add(2);
bar.add(4);
|
Das ist überflüssig, unnütz und unsinnig. Man sieht, dass da eine Liste initialisiert oder befüllt wird. Da gehört also kein Kommentar dran. Trotzdem ist dieses Beispiel schlecht lesbar, weil:
1) "bar" sagt nichts aus. Hieße die Liste "sampleList", dann wäre es schon klarer. Hieße sie z.B. "idsToIgnore", dann wäre sofort klar, welchen Zweck sie erfüllt.
2) 2 und 4 sind Konstanten, die nichts aussagen. Sinnvoll wäre hier eine const-Deklaration mit sprechenden Namen wie "AbstractType" (wahlweise "ABSTRACT_TYPE") und "DeprecatedType". Auch hier wäre dann sofort klar, worum es geht.
Genau solch schlechte und überflüssige Art des Kommentars findet man aber sehr sehr oft in Anfänger-Code, auch dann, wenn er eigentlich "ok" ist. Es kostet nur unnütz Zeit ihn zu schreiben und später wieder zu lesen. Gleich richtig ordentlich lesbaren Code schreiben und gut.