Quellcode Kommentieren

[himitsu]

Zitat von OlafSt:

Dann klingelt das Telefon - der Kunde von damals möchte ein paar Änderungen an dem Ding haben. 15 Jahre alter D7-Code. Da bist du froh, wenn du sauber gearbeitet und ein paar Kommentare hinterlassen hast.

Kommt drauf an.

Wenn keiner den Code versteht, sondern nur noch du (etwas) und die dann auf dich zu kommen müssen, weil kein Anderer es kann, dann spräche CC eher dagegen.

[Stevie]

Zitat von OlafSt:

Da bist du froh, wenn du sauber gearbeitet und ein paar Kommentare hinterlassen hast.

Da stimme ich zu, persönlich versuche ich es mit Kommentaren so zu halten, dass ich nur dann welche schreibe, wenn der code nicht selbsterklärend ist (man wundert sich manchmal, wie schön das mit guter Architektur und Benennung zu lösen ist) und dann auch nicht, was der Code macht (das sieht man schließlich), sondern warum bzw mit welcher Intention.

Zitat von himitsu:

Wenn keiner den Code versteht, sondern nur noch du (etwas) und die dann auf dich zu kommen müssen, weil kein Anderer es kann, dann spräche CC eher dagegen.

Code der Kategorie versuchte Arbeitsplatzsicherung?

[OlafSt]

Zitat von Stevie:

Code der Kategorie versuchte Arbeitsplatzsicherung?

Nä, so'n Murks mach ich nicht. Hab ich auch nie. In meiner ersten Anstellung als Programmierer wurde mir auf nette, aber bestimmte Art das Teamplay beigebracht. Nett, weil es echt Spaß machte und nicht als Schinderei empfunden wurde. Bestimmt, weil Zuwiderhandlungen unangenehm geahndet wurden

However, ich habe diesen Stil konsequent bis heute durchgehalten und ich hätte keine Bedenken, irgendein Projekt an jemanden weiterzugeben, ohne meine Präsenz neben ihm/ihr. Er/Sie wird wenig Probleme haben, sich da reinzufuchsen.

However.

Zitat:

Wenn keiner den Code versteht, sondern nur noch du (etwas) und die dann auf dich zu kommen müssen, weil kein Anderer es kann, dann spräche CC eher dagegen.

Ich denke eher, es war das Problem, einen Delphi-Entwickler aufzutreiben. Die sind dünn gesät und viel gefragt (weshalb es mir seit Jahren ein Rätsel ist, wieso ich keine Anstellung finden konnte). Die Jungs haben sich tatsächlich von Firma zu Firma gehangelt, um mich aufzuspüren. Ich hatte sogar noch ein Exemplar der Datenformatbeschreibung, die da aus dem angerufenen Gerät kam

Sind bis heute meine besten Kunden - aber auch die anspruchsvollsten.

Egal, BTT.

[Dejan Vu]

Zitat von OlafSt:

Die sind dünn gesät und viel gefragt

Letzeres kann nicht sein, weil es nicht stimmen kann: Wenig Delphi-Entwickler produzieren wenige Projekte mit wenig Nachfrage zur Weiterentwicklung und wenig Nachfrage zur Teamvergrößerung. Ergo sind Delphi-Entwickler selten gefragt.

Bezüglich Kommentaren von Legacy-Code: Natürlich ist es besser, Code zu kommentieren, als ihn nicht zu kommentieren. Aber viel besser ist es eben (imho), den Code selbsterklärend zu schreiben, weil damit ja mehrere Fliegen mit einer Klappe erschlagen werden (Lesbarkeit, Wartbarkeit, Testbarkeit, Skalierbarkeit, Foobarkeit usw.)

Ich partizipiere heute noch von meinen Kommentaren in uralten SQL-Prozeduren, weil ich bis heute noch kein vernünftiges Verfahren anwende, um meine CC-Ansprüche auf SQL-Code anzuwenden.

[bernau]

Zitat von Dejan Vu:

Zitat von OlafSt:

Die sind dünn gesät und viel gefragt

Letzeres kann nicht sein, weil es nicht stimmen kann: Wenig Delphi-Entwickler produzieren wenige Projekte mit wenig Nachfrage zur Weiterentwicklung und wenig Nachfrage zur Teamvergrößerung. Ergo sind Delphi-Entwickler selten gefragt.

Wenig Delphi-Entwickler produzieren zwar wenig neues, aber unterschätze nicht die vorhandene Code-Basis, die evtl. erweitert oder gepflegt werden soll. Delphi gibt es ja nicht erst seit gestern.

[himitsu]

Zitat von OlafSt:

Ich denke eher, es war das Problem, einen Delphi-Entwickler aufzutreiben. Die sind dünn gesät und viel gefragt (weshalb es mir seit Jahren ein Rätsel ist, wieso ich keine Anstellung finden konnte). Die Jungs haben sich tatsächlich von Firma zu Firma gehangelt, um mich aufzuspüren.

Komisch, mir kam das mal so vor, als wenn die Firmen garnicht suchen.

Bin mal ganz einfach in eine der wenigen mit Delphi arbeitenden Firmen (laut Telefonbuch gab es nur 3, hier in der Gegend) und hab mehr aus neugier gefragt, wie es eigentlich so aus
sieht, als "doofer" Realschüler und ohne Delphi richtig gelernt zu haben (do it yourself), also ob man da eine Chance in diesem Beruf hätte.
Ohne mich richtig angeguckt zu haben, kam sofort die Antwort "Nö".

[mquadrat]

Bei anständiger Benennung kann man sich viele Kommentare sparen. Aber ich schreib mir teilweise ein paar Notizen rein, wenn Code Seiteneffekte haben kann bzw. hatte. Also sowas in der Art wie "Das muss man hier so machen, weil sonst an Stelle XY nix mehr geht". Wie die meisten hier haben wir es mit zum Teil 14 Jahre altem Code zu tun, damals hat man in der Delphi-Welt noch nicht so sauber gekapselt. Hauptsache RAD.

[Dejan Vu]

[QUOTE=bernau;1267829...unterschätze nicht die vorhandene Code-Basis, die evtl. erweitert oder gepflegt werden soll. Delphi gibt es ja nicht erst seit gestern.[/QUOTE] Mach ich nicht. Es gibt einfach verdammt wenig Firmen, die Delphi-Entwickler suchen, auch auf dem freien Markt. Mag ja sein, das es millionen von Delphi-Projekten da draußen gibt. Vermutlich sind die so endgeil programmiert und erfüllen alle Wünsche, das man einfach keinen Bedarf an Delphi-Programmierern hat. Wäre ja denkbar

Mal wieder OT geworden Schluß damit. Sry.

[p80286]

Zitat von mquadrat:

Bei anständiger Benennung kann man sich viele Kommentare sparen. Aber ich schreib mir teilweise ein paar Notizen rein, wenn Code Seiteneffekte haben kann bzw. hatte. Also sowas in der Art wie "Das muss man hier so machen, weil sonst an Stelle XY nix mehr geht". Wie die meisten hier haben wir es mit zum Teil 14 Jahre altem Code zu tun, damals hat man in der Delphi-Welt noch nicht so sauber gekapselt. Hauptsache RAD.

Ich denke das können die meisten unterschreiben.

Zitat von Dejan Vu:

Ich partizipiere heute noch von meinen Kommentaren in uralten SQL-Prozeduren, weil ich bis heute noch kein vernünftiges Verfahren anwende, um meine CC-Ansprüche auf SQL-Code anzuwenden.

da wird es einem aber auch nicht leicht gemacht, und wenn ich diese EinBustabenAliasse sehe, frag ich mich schon was die Autoren sich dabei denken.

Gruß
K-H

[Dejan Vu]

Zitat von p80286:

da wird es einem aber auch nicht leicht gemacht, und wenn ich diese EinBustabenAliasse sehe, frag ich mich schon was die Autoren sich dabei denken.

Einerseits, aber das ist das kleinere Übel. Aliase sind ja Abkürzungen, denn sonst könntest Du ja auch den Tabellennamen verwenden. Wenn man eine Nomenklatur hat, sodaß für die Kundentabelle immer der Alias 'kd' oder 'k' verwendet wird, dann geht das schon.

Ich meine eher das Verbergen von kodierter Logik ('Status=3 AND RemovalOptions in (3,4,27)') in Views, SP, UDF etc.