spieleprogrammierer.de - Forum und Wiki zur Spieleprogrammierung und Spieleentwicklung

In dem Buch gibt es ja eine Liste guter Kommentararten - zwar auch eine lange Liste mit schlechten Kommentararten - aber pauschal zu sagen

Zitat von »TrommlBomml«

naja wer kommentieren muss hat zu wenig aussagekräftige funktionen...sollte eigentlich selbsterklärend sein... (ausnahmen bestätigen die regel).

ist wohl nicht im Sinne des Autors des Buches, welches du da als Untermauerung heranziehst.
Siehe http://www.amazon.de/gp/reader/013235088…j=1#reader-page

Zitat von »Aus dem Inhaltsverzeichnis«

Good Comments
Legal Comments
Informative Comments
Explanation of Intent
Clarification
Warning of Consequences
TODO Comments
Amplification
Javadocs in Public APIs

Das sind ja wohl nicht "Ausnahmen", sondern einfach gute Kommentare und eben die Kommentare auf die wir uns beziehen...

ja sicherlich gibt es kommentare aber ich fand in bezug auf den code keine passenden. jeder soll seinen codestil durchsetzen. mir persönlich reicht doxygen wenn ich dokumentieren will, ansonsten finde ich klassendiagramme viel sinnvoller.

In Bezug auf welchen Code? Der Code, den jemand, der das erste mal java ausprobiert, geschrieben hat?

Ich verstehe nicht, warum du nach wie vor nicht einsehen willst, dass deine pauschale Aussage wirklich falsch war und gerade Anfänger in Teufels Küche bringen kann (der einzige Grund warum ich überhaupt gegen deine Aussage vorgehe). Klassendiagramme sind auch sinnvoll, aber die in deinem Buch genannten guten Kommentare eben auch...