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. Daimler AG, Germersheim
  2. Schwarz IT Infrastructure & Operations Services GmbH & Co. KG, Neckarsulm
  3. PDV-Systeme GmbH, Goslar
  4. IT-Dienstleistungszentrum Berlin Anstalt des öffentlichen Rechts, Berlin

Golem pur
  • Golem.de ohne Werbung nutzen

Anzeige
Spiele-Angebote
  1. (-65%) 6,99€
  2. 18,99€
  3. 22,13€ inkl. Versand


Haben wir etwas übersehen?

E-Mail an news@golem.de


Canon EOS 5D Mark IV im Test: Grundsolides Arbeitstier mit einer Portion Extravaganz
Canon EOS 5D Mark IV im Test
Grundsolides Arbeitstier mit einer Portion Extravaganz
  1. Video Youtube spielt Livestreams in 4K ab
  2. Ausgabegeräte Youtube unterstützt Videos mit High Dynamic Range
  3. Canon EOS M5 Canons neue Systemkamera hat einen integrierten Sucher

Named Data Networking: NDN soll das Internet revolutionieren
Named Data Networking
NDN soll das Internet revolutionieren
  1. Geheime Überwachung Der Kanarienvogel von Riseup singt nicht mehr
  2. Bundesförderung Bundesländer lassen beim Breitbandausbau Milliarden liegen
  3. Internet Protocol Der Adresskollaps von IPv4 kann verzögert werden

Travelers Box: Münzgeld am Flughafen tauschen
Travelers Box
Münzgeld am Flughafen tauschen
  1. Apple Siri überweist Geld per Paypal mit einem Sprachbefehl
  2. Soziales Netzwerk Paypal-Zahlungen bei Facebook und im Messenger möglich
  3. Zahlungsabwickler Paypal Deutschland bietet kostenlose Rücksendungen an

  1. Ultrastar He12: WD plant Festplatten mit bis zu 14 Terabyte
    Ultrastar He12
    WD plant Festplatten mit bis zu 14 Terabyte

    Im kommenden Jahr sollen die ersten HDD mit 12 und 14 Terabyte Kapazität erscheinen: Western Digital möchte Helium-gefüllte Festplatten mit acht Plattern anbieten, die größere Spezialversion setzt auf überlappende Spuren.

  2. LG: Weitere Hinweise auf Aufgabe des bisherigen Modulsystems
    LG
    Weitere Hinweise auf Aufgabe des bisherigen Modulsystems

    Insidern zufolge soll LG beim kommenden G6 auf ein wasserdichtes Design setzen. Ein modularer Aufbau des kommenden Top-Smartphones wie beim G5 wird dadurch unwahrscheinlich. Das deckt sich mit früheren Vermutungen südkoreanischer Industrievertreter.

  3. Onlinewerbung: Forscher stoppen monatelange Malvertising-Kampagne
    Onlinewerbung
    Forscher stoppen monatelange Malvertising-Kampagne

    Über eine Malvertising-Kampagne ist in den vergangenen Monaten Schadcode verteilt worden. Die Macher des Stegano-Exploit-Kits versteckten dabei unsichtbare Pixel in Werbeanzeigen und nutzen Exploits in Flash und dem Internet Explorer.


  1. 14:43

  2. 14:20

  3. 14:07

  4. 14:00

  5. 13:10

  6. 12:25

  7. 11:59

  8. 11:44