AGB  ·  Datenschutz  ·  Impressum  







Anmelden
Nützliche Links
Registrieren

Guter Code

Offene Frage von "jaenicke"
Ein Thema von PascalDeveloper · begonnen am 14. Feb 2018 · letzter Beitrag vom 2. Mär 2018
Antwort Antwort
Seite 3 von 5     123 45   
freimatz

Registriert seit: 20. Mai 2010
1.450 Beiträge
 
Delphi 11 Alexandria
 
#21

AW: Guter Code

  Alt 15. Feb 2018, 18:02
Zitat:
...ist durch richtige Kommentierung auch nach 3..n Monaten noch verständlich.
Nein, benötigt keine Kommentierung. Wenn ein Code einer Kommentierung bedarf die erklärt was der Code macht ist der code schlecht.
Gut ist Kommentierung nur, wenn sie erklärt WARUM es gemacht wird.

Zitat:
Ich toleriere auch einen abweichenden Style anderer, und das sogar gern... einfach weil es gut ist, wenn man schon nach 2 Bildschirmseiten "sicher" erkennt wer das programmiert hat. Man weiß wenn was nicht(mehr) klappt an wen man sich wenden muss bzw. bei den "Ex...", an wen man sich nicht mehr direkt wenden kann.
Den Grund lasse ich nicht gelten, denn dafür gibt es Tools (Blame)

Das Wichtigste für mich ist immer noch:
Zitat:
Da ist eigentlich alles andere hier mit drin.

Und außerdem: Es freut mich shr dass du dich für guten Code interssierst. Das ist schon mal die Grundvoraussetzung.
  Mit Zitat antworten Zitat
Benutzerbild von himitsu
himitsu
Online

Registriert seit: 11. Okt 2003
Ort: Elbflorenz
44.119 Beiträge
 
Delphi 12 Athens
 
#22

AW: Guter Code

  Alt 15. Feb 2018, 18:53
Zitat:
denn dafür gibt es Tools (Blame)
Wenn er das aber umformatiert und eincheckt, dann steht er selbst dort als "Schuldiger" drin.
Neuste Erkenntnis:
Seit Pos einen dritten Parameter hat,
wird PoSex im Delphi viel seltener praktiziert.
  Mit Zitat antworten Zitat
Delphi-Laie

Registriert seit: 25. Nov 2005
1.474 Beiträge
 
Delphi 10.1 Berlin Starter
 
#23

AW: Guter Code

  Alt 15. Feb 2018, 19:12
Zitat:
...ist durch richtige Kommentierung auch nach 3..n Monaten noch verständlich.
Nein, benötigt keine Kommentierung. Wenn ein Code einer Kommentierung bedarf die erklärt was der Code macht ist der code schlecht.
Gut ist Kommentierung nur, wenn sie erklärt WARUM es gemacht wird.
Was der Code macht, muß man nie erklären, denn das sieht man ja selbst.
  Mit Zitat antworten Zitat
Benutzerbild von himitsu
himitsu
Online

Registriert seit: 11. Okt 2003
Ort: Elbflorenz
44.119 Beiträge
 
Delphi 12 Athens
 
#24

AW: Guter Code

  Alt 15. Feb 2018, 19:33
Sag das mal den Lehrern.
i := i + 1; // Addiere 1 zur Variable i

Ich hatte hier in der DP einmal das beste Antipattern für Überkommentierung gesehn, da war wirklich jeder einzelne Befehl kommentiert.
(leider vergessen mir den Post zu merken )
Nachbauen kann ich diesen Antipattern leider nicht. Hatte ich schon versucht, aber so schön bekam ich das einfach nicht hin.

Das Ergebnis war, dass man den einzigen "wichtigen" Kommentar so garnicht bemerkte.
Neuste Erkenntnis:
Seit Pos einen dritten Parameter hat,
wird PoSex im Delphi viel seltener praktiziert.

Geändert von himitsu (15. Feb 2018 um 19:38 Uhr)
  Mit Zitat antworten Zitat
Benutzerbild von Luckie
Luckie

Registriert seit: 29. Mai 2002
37.621 Beiträge
 
Delphi 2006 Professional
 
#25

AW: Guter Code

  Alt 15. Feb 2018, 19:38
Ich habe her http://michael-puff.de/Programmierun...leanCode.shtml die wichtigsten Punkte aus dem Buch Clean Code von Robert C. Martin zusammen getragen.
Michael
Ein Teil meines Codes würde euch verunsichern.
  Mit Zitat antworten Zitat
Benutzerbild von p80286
p80286

Registriert seit: 28. Apr 2008
Ort: Stolberg (Rhl)
6.659 Beiträge
 
FreePascal / Lazarus
 
#26

AW: Guter Code

  Alt 15. Feb 2018, 19:48
Also was die Kommentierung angeht, bin ich der Meinung, daß z.B. API-Aufrufe immer kommentiert gehören. Aber darüber kann man trefflich streiten.
Da ich mit dem IBM-BIOS aufgewachsen bin, kommentiere ich u.U. etwas zu viel.

Gruß
K-H
Programme gehorchen nicht Deinen Absichten sondern Deinen Anweisungen
R.E.D retired error detector
  Mit Zitat antworten Zitat
Benutzerbild von himitsu
himitsu
Online

Registriert seit: 11. Okt 2003
Ort: Elbflorenz
44.119 Beiträge
 
Delphi 12 Athens
 
#27

AW: Guter Code

  Alt 15. Feb 2018, 19:56
Ein paar Beispiele für nicht immer sehr gute Kommentare und Codes.
http://www.delphipraxis.net/96226-eu...ommentare.html

@Herr Puff, sie wurden schon 5 Kommentare vorher verpetzt.
Neuste Erkenntnis:
Seit Pos einen dritten Parameter hat,
wird PoSex im Delphi viel seltener praktiziert.
  Mit Zitat antworten Zitat
Benutzerbild von Luckie
Luckie

Registriert seit: 29. Mai 2002
37.621 Beiträge
 
Delphi 2006 Professional
 
#28

AW: Guter Code

  Alt 15. Feb 2018, 20:21
@Herr Puff, sie wurden schon 5 Kommentare vorher verpetzt.
Wenn ich den erwische!
Michael
Ein Teil meines Codes würde euch verunsichern.
  Mit Zitat antworten Zitat
PascalDeveloper

Registriert seit: 14. Feb 2018
3 Beiträge
 
#29

AW: Guter Code

  Alt 28. Feb 2018, 14:44
Vielen Dank für die Antworten ich habe mir Jetzt das Buch Clean code von Robert C. gekauft welches sehr ausführlich und informativ ist.
  Mit Zitat antworten Zitat
PascalDeveloper

Registriert seit: 14. Feb 2018
3 Beiträge
 
#30

AW: Guter Code

  Alt 28. Feb 2018, 14:46
Vielen Dank für die Antworten ich habe mir jetzt das Buch Clean code von Robert C. gekauft welches sehr gut ist und ich nur weiterempfehlen kann
  Mit Zitat antworten Zitat
Themen-Optionen Thema durchsuchen
Thema durchsuchen:

Erweiterte Suche
Ansicht

Forumregeln

Es ist dir nicht erlaubt, neue Themen zu verfassen.
Es ist dir nicht erlaubt, auf Beiträge zu antworten.
Es ist dir nicht erlaubt, Anhänge hochzuladen.
Es ist dir nicht erlaubt, deine Beiträge zu bearbeiten.

BB-Code ist an.
Smileys sind an.
[IMG] Code ist an.
HTML-Code ist aus.
Trackbacks are an
Pingbacks are an
Refbacks are aus

Gehe zu:

Impressum · AGB · Datenschutz · Nach oben
Alle Zeitangaben in WEZ +1. Es ist jetzt 17:34 Uhr.
Powered by vBulletin® Copyright ©2000 - 2024, Jelsoft Enterprises Ltd.
LinkBacks Enabled by vBSEO © 2011, Crawlability, Inc.
Delphi-PRAXiS (c) 2002 - 2023 by Daniel R. Wolf, 2024 by Thomas Breitkreuz