Abo
  1. Foren
  2. Kommentare
  3. Applikationen
  4. Alle Kommentare zum Artikel
  5. › Computer History Museum…

Codekommentare

Anzeige
  1. Thema

Neues Thema Ansicht wechseln


  1. Codekommentare

    Autor: Beeblox 15.02.13 - 09:27

    > Dass dem Code Kommentare fehlen, sieht Booch eher positiv, denn der Quelltext sei so gut zu lesen, dass Kommentare das vermutlich eher erschwert hätten.

    Eine Erkenntnis, die sich ruhig ein bisschen weiter durchsetzen könnte: Viel besser als das Kommentieren von Code ist es, den Code selbst lesbar zu schreiben. Mit dem Aufkommen von Tools JavaDoc/Doxygen/etc ist es ja leider Usus geworden, Code unleserlich zu schreiben UND schlecht zu dokumentieren.

  2. Re: Codekommentare

    Autor: pythoneer 15.02.13 - 09:37

    Beeblox schrieb:
    --------------------------------------------------------------------------------
    > Mit dem Aufkommen von Tools JavaDoc/Doxygen/etc ist es ja leider
    > Usus geworden, Code unleserlich zu schreiben UND schlecht zu dokumentieren.

    Ernsthaft? JavaDoc/Doxygen/etc hat mir das lesen von Code noch nie erschwert. Ich bin dankbar, wenn ich vor der Funktion/Klasse/etc lesen kann was sie macht. JavaDoc/Doxygen/etc schreibt man doch nicht mitten in den Code wie man es bei normalen Kommentaren macht, sondern als Präambel zu den entsprechenden Elementen. Wer das nicht lesen möchte/braucht überspringt es einfach, im Code hat das Zeugs doch eh nix zu suchen.

  3. Re: Codekommentare

    Autor: Trollster 15.02.13 - 09:46

    Kommentare schreiben muss auch gelernt sein, viele schreiben zu viel und zu unübersichtlich.

    Ist wie guten Code schreiben, beides nicht so einfach für manche.

  4. Re: Codekommentare

    Autor: Beeblox 15.02.13 - 09:47

    pythoneer schrieb:
    --------------------------------------------------------------------------------
    > Beeblox schrieb:
    > ---------------------------------------------------------------------------
    > -----
    > > Mit dem Aufkommen von Tools JavaDoc/Doxygen/etc ist es ja leider
    > > Usus geworden, Code unleserlich zu schreiben UND schlecht zu
    > dokumentieren.
    >
    > Ernsthaft? JavaDoc/Doxygen/etc hat mir das lesen von Code noch nie
    > erschwert.

    Das meinte ich auch nicht. Es führt aber erfahrungsgemäß dazu, dass der Entwickler nicht mehr so stark darauf achtet, dass der Code selbst lesbar ist.

    > Ich bin dankbar, wenn ich vor der Funktion/Klasse/etc lesen kann
    > was sie macht.

    Wenn das nicht aus dem Kontext der Methode ersichtlich ist, ist das schonmal ein Code smell. (Was tut wohl eine Funktion "contains" auf einer Liste?) Allenfalls die Dokumentation von Randfällen / Fehlerverhalten mag sinnvoll sein - sofern sie auch gepflegt wird und nicht nach 2 Revisionen falsch oder zumindest unvollständig ist. Das ist eher der Regelfall.



    1 mal bearbeitet, zuletzt am 15.02.13 09:49 durch Beeblox.

  5. Re: Codekommentare

    Autor: teenriot 15.02.13 - 09:57

    Ein häufiges Problem ist meiner Meinung nach sich 'hineinzufühlen' in einen späteren Zeitpunkt und das zu kommentieren was einem im Moment der Code-Erstellung für selbstverständlich logisch und nicht aufschreibenswert erscheint.
    Man ist im Moment der Code-Erstellung zu nah dran um für jemanden bzw sich selbst zu schreiben für den Umstand das man irgendwann 'weit weg' ist.

  6. Re: Codekommentare

    Autor: dabbes 15.02.13 - 10:47

    Und was macht eine Funktion "contains" mit einer Liste, die aus zig Datenquellen zusammengesetzt ist oder relativ komplexe Datenquelle hat?
    Richtig, das gleiche, aber ohne ordentliche Doku muss ich mir die komplette Funktion anschauen, um zu erkennen, welche Datenquellen wie verwendet werden.

    Guter Code (gute Bezeichner usw.) ist sehr wichtig, ersetzt dennoch keine Doku.

  7. Re: Codekommentare

    Autor: BLi8819 15.02.13 - 11:24

    Grundsätzlich denke ich auch: Wenn Kommentare zwingend notwendig sind, um den Code zu verstehen, ist was schief gelaufen.

    Dennoch finde ich es Sinnvoll die Funktion des Codes auch textuell zu beschreiben. Gerade im Team will ich nicht immer jede Funktion lesen, um zu verstehen, was genau in Ihr passiert.

    Damals in meiner Ausbildung wurde mir immer eingeredet, so viele Kommentare zu machen, wie nur geht. Irgendwann hat man den Code vor lauter Kommentaren gar nicht mehr gesehen.

    Gar keine Kommentare sind aber auch nicht gut. Gerade wenn neue Leute ins Team kommen, sind Kommentare Gold Wert.

    Und manchmal ist es auch gut, einfach selbst nochmal darüber nachzudenken, was man da gerade programmiert hat :-D

  8. Re: Codekommentare

    Autor: Vash 15.02.13 - 13:12

    BLi8819 schrieb:
    --------------------------------------------------------------------------------
    > [...]
    > Gar keine Kommentare sind aber auch nicht gut. Gerade wenn neue Leute ins
    > Team kommen, sind Kommentare Gold Wert.
    >
    > Und manchmal ist es auch gut, einfach selbst nochmal darüber nachzudenken,
    > was man da gerade programmiert hat :-D

    Für mich sind das die beiden wichtigsten Punkte.

    Neben dem wäre noch erwähnenswert das gewisse IDEs in der Lage sind die Funktionskommentare bei der Nutzung der Funktion einzublenden - was oftmals das hinnavigieren, lesen und verstehen der Funktion erleichtert.

    Insbesondere dann wenn diese Funktionen nicht trivial sind, die Implementierung in weiteren Bibliotheken versteckt die vielleicht weder einsehbar noch dokumentiert sind, usw.

  9. IT News für Profis

    Autor: KleinerWolf 16.02.13 - 10:44

    und hier kommen die Hobby Entwickler aus ihren Höhlen gekrochen.

    wir haben mehrere Projekte, ca 3,5-4 Millionen Zeilen Code. Teilstücke sind 25 Jahre alt (C) und über die Jahre hatte mind. 10 Entwickler ihre Finger im Code, welche teilweise nicht mehr in der Firma arbeiten.

    Und dann kommen hier Leute, die evtl ein Programm mit 1000 ( oder lass mal 10k ) Zeilen Code geschrieben haben und erzählen das Kommentare überflüssig sind.

  10. Re: Codekommentare

    Autor: KleinerWolf 16.02.13 - 10:49

    Ich frag mich was ihr teilweise programmiert, das ihr das so verallgemeinert. Es gibt Schnittstellen mit technischen Geräten, die sind so komplex, dass man zwangsläufig Kommentare ( schon für sich selber ) in den Code schreibt.
    Da reicht oft nicht nur eine Dokumentation, sondern man will sich selbst, oder anderen an gewissen Stellen im Code einem direkt klar machen was es macht, oder was man evtl beachten muss.

    Hier denken einige von der Wand bis zur Tapete in ihrer kleinen Hobbyentwicklung.

  11. Re: IT News für Profis

    Autor: das sushi 16.02.13 - 12:06

    programmieren ist aber mehr als kommentare zu schreiben, wie hier schon geschrieben wurde sind kommentare veraltet wenn sie geschrieben wurden, ja manche sachen müssen dokumentiert werden, aber komplexe dokumentationen gehören nicht in den code, ausserdem wenn ein interface so komplex ist das es ne 5 seitige dokumentation braucht, sollte man sich fragen was an dem interface falsch ist, es ist besser kleine schlanke komponenten zu bauen die sich gut warten lassen als code-monster zu schaffen die nach einem halben jahr keiner mehr versteht, programmieren ist ebend mehr als den code einfach nur runter zu tippen, mann muss sich auch gedanken über die struktur, wartbeikeit und zukunfttauglichkeit machen

  12. Re: Codekommentare

    Autor: Eve666 16.02.13 - 12:11

    Ich arbeite momentan an einem Projekt mit inzwischen 4,3 Mio LOC (35 Entwickler) und wir haben keine Kommentare, weil sie nicht benötigt werden. Wenn man streng nach den Regeln des TDD entwickelt und das SRP zur obersten Regel erklärt, dann sind Funktionen niemals schwierig zu verstehen. Die 4-8 Zeilen pro Funktion kann wirklich jeder überblicken. Mit anderen Worten CleanCode funktioniert.

  13. Re: Codekommentare

    Autor: sknoche 16.02.13 - 15:10

    Dem kann ich nur beipflichten.

    In dem Moment, wo zum Verständnis von Code ein Kommentar nötig ist, sollte man sich mal Gedanken machen, ob man diese Stelle nicht besser refactored...

    Kommentare sollten eigentlich nur in Ausnahmefällen zum Zuge kommen, z.B. um die Gründe eines "eigenwilligen" Implementierungsansätze zu erläutern, oder eine Erklärung für nicht offensichtlich notwendige Fehlerbehandlungen zu liefern.

  14. Re: IT News für Profis

    Autor: GodsBoss 16.02.13 - 16:19

    Beitrag von Eve666

    Dass alle Kommentare immer überflüssig sind – halte ich für falsch. Dass in vielen Projekten der überwiegende Teil der Kommentare weggelassen werden könnte, wenn man den Code umbauen würde, halte ich hingegen für richtig.

    Reden ist Silber, Schweigen ist Gold, meine Ausführungen sind Platin.

  15. Re: IT News für Profis

    Autor: ghj 16.02.13 - 16:48

    KleinerWolf schrieb:
    --------------------------------------------------------------------------------
    > und hier kommen die Hobby Entwickler aus ihren Höhlen gekrochen.
    >
    Und da kommen sie, die wir haben das schon immer so gemacht, seit 20...30 Jahren lernresistenten :)



    1 mal bearbeitet, zuletzt am 16.02.13 16:49 durch ghj.

  16. Re: Codekommentare

    Autor: kiviuq 17.02.13 - 11:26

    Ist das Problem / Use Cases allgemein bekannt, die entsprechenden Methoden in der Literatur besprochen sind, braucht man echt keine Kommentare. Zum Beispiel mathematische Probleme oder so etwas wie GoF.

    Nur der gemeine Anwendungsentwickler hat 99% der Fälle mit irgendwelchen abstrusen fachlichen, gesetzlichen oder politischen Anforderungen zu tun, altem Code, unmöglichen Datenmodellen usw., dass man ohne Kommentare eigentliche nicht mehr nachvollziehen kann, warum etwas nun so und nicht anders gemacht werden kann. Da geht's eher um das Warum als das Wie.

    Bei einem Kommentar, weiß man leider nie, ob er überhaupt noch etwas mit der betreffenden Codestelle zu tun hat. Ich mach's halt immer so, dass ich mir die Kommies mit einem Abstand von ein paar Tage noch einmal durchlese und korrigiere.

    Viel wichtiger aber als Kommentare ,sind aber immer noch gute Unit-Tests und(!!) kurze Methoden ohne Seiteneffekte.

  17. Re: Codekommentare

    Autor: GodsBoss 17.02.13 - 18:41

    > Viel wichtiger aber als Kommentare ,sind aber immer noch gute Unit-Tests
    > und(!!) kurze Methoden ohne Seiteneffekte.

    Dito. So wirklich gute Tests lassen sich glatt als Dokumentation verwenden. Die ist dann wenigstens immer aktuell.

    Reden ist Silber, Schweigen ist Gold, meine Ausführungen sind Platin.

Neues Thema Ansicht wechseln


Um zu kommentieren, loggen Sie sich bitte ein oder registrieren Sie sich. Zum Login

Anzeige
Stellenmarkt
  1. Continental AG, Ingolstadt
  2. Telekom Deutschland GmbH, Bonn
  3. Schaeffler, Herzogenaurach
  4. ADAC Nordbayern e.V., Nürnberg

Golem pur
  • Golem.de ohne Werbung nutzen

Anzeige
Spiele-Angebote
  1. (-78%) 8,99€
  2. 22,99€
  3. 18,99€


Haben wir etwas übersehen?

E-Mail an news@golem.de


Yodobashi und Bic Camera: Im Rausch der Netzwerkkabel
Yodobashi und Bic Camera
Im Rausch der Netzwerkkabel
  1. Sicherheitslücke Fehlerhaft konfiguriertes Git-Verzeichnis bei Redcoon
  2. Preisschild Media Markt nennt 7.998-Euro-Literpreis für Druckertinte

Vernetzte Hörgeräte und Hearables: Ich filter mir die Welt widdewiddewie sie mir gefällt
Vernetzte Hörgeräte und Hearables
Ich filter mir die Welt widdewiddewie sie mir gefällt
  1. The Dash Pro Bragis Drahtlos-Ohrstöpsel können jetzt auch übersetzen
  2. Beddit Apple kauft Schlaf-Tracker-Hersteller
  3. Smartwatch Huawei Watch bekommt Android Wear 2.0

In eigener Sache: Die Quanten kommen!
In eigener Sache
Die Quanten kommen!
  1. id Software "Global Illumination ist derzeit die größte Herausforderung"
  2. In eigener Sache Golem.de führt kostenpflichtige Links ein
  3. In eigener Sache Golem.de sucht Marketing Manager (w/m)

  1. Betrugsverdacht: Amazon Deutschland sperrt willkürlich Marketplace-Händler
    Betrugsverdacht
    Amazon Deutschland sperrt willkürlich Marketplace-Händler

    Nach vermehrten Betrugsfällen sperrt Amazon nun Marketplace-Konten grundlos. Wer die Bankverbindung oder den Rechner wechselt, ist bereits verdächtig.

  2. Take 2: GTA 5 bringt weiter Geld in die Kassen
    Take 2
    GTA 5 bringt weiter Geld in die Kassen

    Nach Bekanntgabe des neuen Termins für Red Dead Redemption 2 ist der Aktienkurs von Take 2 eingebrochen, inzwischen erholt er sich wieder etwas: Dank GTA 5 und weiterer Erfolgstitel wie Mafia 3 hat der Publisher in den letzten Monaten prächtig verdient.

  3. 50 MBit/s: Bundesland erreicht kompletten Internetausbau ohne Zuschüsse
    50 MBit/s
    Bundesland erreicht kompletten Internetausbau ohne Zuschüsse

    Durch einen Mix interessanter Bereiche mit weniger attraktiven Gebieten schafft das Saarland den Internetausbau ohne Subventionen. Doch es werden erst einmal nur mindestens 50 MBit/s angestrebt. Auch die Telekom ist dabei.


  1. 16:58

  2. 16:10

  3. 15:22

  4. 14:59

  5. 14:30

  6. 14:20

  7. 13:36

  8. 13:20