Mir ist klar, dass das Format "Header-Kommentar" von Programmierer zu Programmierer unterschiedlich ist, aber was wäre ein Beispiel für einen "guten" Header-Kommentar?
c++
coding-style
comments
code-formatting
headers
Mateen Ulhaq
quelle
quelle
Antworten:
In Bezug auf den Formatierungsstil ist Konsistenz am wichtigsten. Stellen Sie sicher, dass jeder Klassendefinitionskommentar wie jeder andere aussieht , jeder Methodenkommentar wie jeder andere aussieht usw.
Wenn Sie also vorhandenen Code ändern , stellen Sie sicher, dass Sie dessen Formatierungsstil befolgen. Die Kommentare (und bis zu einem gewissen Grad auch der Code) sollten so aussehen, als hätte nur eine Person an der Datei gearbeitet. Wenn Sie ein neues Projekt starten, wählen Sie ein Stilformat und bleiben Sie dabei.
Orte, an denen man anfangen kann zu suchen:
quelle