Eure besten Quellcode Kommentare...

[MaBuSE]

Zitat:

Zitat von Medium (Beitrag 1495051)

Jap, das ist genau warum ich das auch gerne mal einsetze. Sonst schnappt sich ein Thread der sonst auf nichts wartet nämlich einfach mal 100% CPU Auslastung.

Dann passt doch der Name ;)

Zitat:

TOP DEFINITION ( https://www.urbandictionary.com/defi...erm=WHARRGARBL )

WHARRGARBL

1. The caption of a popular "loldog" (dog version of lolcat) showing a dog attempting to drink from a lawn sprinkler. Word refers to the sound the dog presumably is making as it angrily (and pointlessly) attempts to subdue the water stream. (The sound dogs make when they attempt to drink out of lawn sprinklers.)
2. A one-word stand-in for any angry, incoherent, pointless reaction, comment, or attack. In online forums, the loldog referenced in (1) is often used to make the point that someone's position is incoherent, illogical, and or pointless. Simply writing 'WHARRGARBL' is also sufficient to make the point, and is especially effective if the target of your insult is one of the few people unfamiliar with the loldog.

Note that incoherence or pointlessness is required for a proper WHARRGARBL reference. An angry, but otherwise logical, argument is not a WHARRGARBL. An argument that takes a reasonable (or at least arguable) position, but does so with an incoherent rant IS a valid WHARRGARBL.

Coherence and logic (or the lack thereof) is in the eye of the beholder, of course. On the internets, any argument that disagrees with yours may be a valid WHARRGARBL.

[himitsu]

Manmal würde ich mir wünschen, wenn es überhaupt Kommentare oder wenigstens eine halbwegs verständliche Hilfe gäbe,
aber wenn man schon tagelang verzweifelt sucht und von einem Problem ins nächste stolpert,
und dann einen Artikel findet, ala "The Worst API Ever Made",
dann vergeht einem auch das letzte Bissl an Lust.

Wenn ich mal was fand und dort standen Kommentare ... dann stimmten sie garnicht. :freak:

Und der einzige gut aussehende Code, als Antwort auf eine Frage ....... der bracht mitten drin ab. :wall:



https://caseymuratori.com/blog_0025

Hatte die überschrift erst garnicht gesehn und dachte "geil", endlich mal was, das ausführlich aussieht und wirklich um das geht, was ich suche (nicht um irgendwas anderes, mit dem Wort "Trace")

[MaBuSE]

Zitat:

Zitat von himitsu (Beitrag 1512429)

Manmal würde ich mir wünschen, wenn es überhaupt Kommentare oder wenigstens eine halbwegs verständliche Hilfe gäbe,

Das kenne ich.

Ich habe auch schon Projekte gesehen, die mehrere Mio Zeilen Quelltext lang sind und per Definition in ca. einer Stunde entstanden sein müssen. :shock:
Na ja, bei uns gibt es eine Arbeitsanweisung, dass ca. 10% der Zeit für Dokumentation einzuplanen ist.
Und der/die Entwickler haben sich nicht mal 10 Min Zeit genommen für Doku und Kommentare.

[dummzeuch]

Besser gar keine Kommentare als falsche oder sinnlose ala

Delphi-Quellcode:

// *******************
// * Prozdur bla     *
// *******************
procedure bla;
var
  i: integer; // Schleifenvariable
begin
  // alle Listenelemente durchlaufen
  for i := 0 to Liste.Count -1 do begin
    // Listenelement verarbeiten
    Process(Liste[i]);
  end;
end;

letztere reduzieren die Lesbarkeit ohne irgendwas beizutragen.

Programmierer sollten sich besser auf verständlichen Code (Struktur und Namensgebung) konzentrieren als auf Teufel komm raus Kommentare zu schreiben. Kommentare sollen beschreiben, warum etwas auf eine bestimmte Weise gemacht wird, und das auch nur dann, wenn es nicht offensichtlich ist.

[DeddyH]

:thumb:

[Uwe Raabe]

Zitat:

Zitat von dummzeuch (Beitrag 1512453)

Programmierer sollten sich besser auf verständlichen Code (Struktur und Namensgebung) konzentrieren als auf Teufel komm raus Kommentare zu schreiben. Kommentare sollen beschreiben, warum etwas auf eine bestimmte Weise gemacht wird, und das auch nur dann, wenn es nicht offensichtlich ist.

:thumb:

Zitat:

Zitat von Brian W Kernighan and P. J. Plaugher

Don't comment bad code - rewrite it.

[himitsu]

Dein Beispiel klingt wie die Hilfe einer gewissen Firma.

Zitat:

Ohh, ein neues Property, mit unverständlichem Namen
...

[F1]
mal gucken was das machen soll

Zitat:

Zitat von OH

Das ist Property Abc in Klasse Xyz der unit Qrs.

UND WAS MACHT DAS NUN?

Genauso wie "oh, komischer Prozess" im Taskmanager .... fragen wir mal G/Y/B/... und die Top10 Suchergebnisse sagen alle

Zitat:

das ist Abc.exe soundsogroß in Verzeichnis hierundda der Firma "NameAusVersionsresource"

UND WAS MACHT DIE NUN?

Das ALLES wusste man auch vorher schon.



Es gibt in Firmen teilweise vorschriften, wonach x% des Quellcodes Kommentare sein müssen.

Da kommt dann auch oft sowas bei raus.

[MaBuSE]

Zitat:

Zitat von himitsu (Beitrag 1512456)

Es gibt in Firmen teilweise vorschriften, wonach x% des Quellcodes Kommentare sein müssen.
Da kommt dann auch oft sowas bei raus.

In Deiner Brust scheinen 2 Herzen zu schlagen ;)

Einerseits schreibst Du, dass wenn Firmen den Entwicklern vorschreiben, sie möchten bitte dokumentieren (Quellcode, Handbücher, Readme, ...), oft nur Müll rauskommt.

Zitat:

Zitat von himitsu (Beitrag 1512429)

Manmal würde ich mir wünschen, wenn es überhaupt Kommentare oder wenigstens eine halbwegs verständliche Hilfe gäbe,
aber wenn man schon tagelang verzweifelt sucht und von einem Problem ins nächste stolpert,...

Andererseits möchtest Du in Quellcode Kommentare und "wenigstens eine halbwegs verständliche Hilfe" haben.

Zitat:

Zitat von MaBuSE (Beitrag 1512445)

Ich habe auch schon Projekte gesehen, die mehrere Mio Zeilen Quelltext lang sind und per Definition in ca. einer Stunde entstanden sein müssen. :shock:
Na ja, bei uns gibt es eine Arbeitsanweisung, dass ca. 10% der Zeit für Dokumentation einzuplanen ist.
Und der/die Entwickler haben sich nicht mal 10 Min Zeit genommen für Doku und Kommentare.

Bei uns gibt es die Richtlinie, dass in der Zeitschätzung ca. 10 % für Dokumentation vorzusehen sind.
Das beinhaltet Quellcode Kommentare, Readme Dateien, Installations-Anweisungen, Benutzerbücher, ...

Der Entwickler nutzt die 10% aber lieber als Puffer um seine Arbeit fristgerecht abzuschließen. Doku ist ja nicht wichtig. :(

[himitsu]

Das Beispiel aus #514, hatten wir hier öfters mal.

Grade in dem was man in einigen Schulen lernen soll, da war wirklich jede einzelne Zeile kommentiert, was da gemacht wird, auch wenn 95% davon der Quellcode selber gesagt hat nd weitere 4%, wenn man ordentliche Namen für Variablen/Funktionen benutzt hätte.
Nur die eine Zeile, die jemand nicht verstand, weil es dem Code nicht richtig anzusehn ist, was ermacht, das war Die ohne Kommentar.



Kommentare nur um des Kommentares Willen, ohne dass er einen Mehrwert bringt, außer den Code zwischen sich untergehen zu lassen ... nja

[Maliko]

Zitat:

Zitat von dummzeuch (Beitrag 1512453)

Besser gar keine Kommentare als falsche oder sinnlose ala

Delphi-Quellcode:

// *******************
// * Prozdur bla     *
// *******************
procedure bla;
var
  i: integer; // Schleifenvariable
begin
  // alle Listenelemente durchlaufen
  for i := 0 to Liste.Count -1 do begin
    // Listenelement verarbeiten
    Process(Liste[i]);
  end;
end;

Leider gibt es immer wieder Firmen die genau sowas wollen. Ich war mal in einer Firma, da sah der Quellcode genauso aus, weil der Entwicklungsleiter darauf bestanden hat, dass jede einzelne Zeile Code kommentiert werden muss. Da kommt dann so ein Müll bei raus. Manchmal habe ich fürs Kommentieren länger gebraucht als für das Schreiben der Funktion.