Boehrsi.de - Blog

Die häufigsten Fehler beim Programmieren - Kommentare

Erstellt am event Uhr von account_circle Boehrsi in label Archiv

Heute möchte ich mit einer kleinen Reihe starten in der ich euch meine Erfahrungen mit dem programmieren etwas näher bringen will. Um genau zu sein möchte ich euch Fehler die ich gemacht habe mitteilen, sodass ihr sie vielleicht nicht machen müsst. Beginnen werde ich mit den Kommentaren: Sie sind nützlich, helfen den Code zu verstehen, können zur Strukturierung genutzt werden und sind auch sonst nicht sonderlich unbeliebt. Doch einen Nachteil haben sie, sie müssen erstellt werden und wer hat auf so etwas nach mehreren Stunden programmieren schon Lust? Ich zu Beginn nicht, ich dachte mir ich habe die Programme ja selber geschrieben also verstehe ich sie ja wohl auch später noch. Ein typischer Fall von denken ist nicht wissen, denn natürlich verändern sich Programme durch Updates und ähnliches etwas und man arbeitet hier und da weiter am Programm und somit versteht man irgendwann nur noch Bahnhof. Dies gilt gerade auch dann, wenn man wie ich mit verschiedenen Sprachen arbeitet. Soll heißen, immer Kommentare schreiben, auch bei Programmen an denen nur ihr arbeitet. Weiterhin hatte ich eben beschrieben, dass keiner Lust hat im Nachhinein noch Kommentare zum Code zu erstellen, also noch ein Tipp von meiner Seite: Kommentare sollten direkt während der Code-Erstellung geschrieben werden und nicht erst danach. Außerdem solltet ihr euch vorher überlegen wie die Kommentare erstellt werden, also z.B. Tags für TODO nutzen, wie man es aus Eclipse kennt, um so später besser zu sehen wo ihr weiter programmieren müsst. Und auch ob ihr Tools wie z.B. Doxygen open_in_new nutzt, um auch extern später auf eine Dokumentation zugreifen zu können, solltet ihr euch überlegen. Viele dieser Tools bedürfen nicht wirklich viel mehr Aufwand, weder beim installieren, noch beim erstellen der Kommentare selber. Deswegen ist ein Blick auf solche Tools, gerade bei größeren Projekten, vermutlich nicht dumm.

Kommentare  
Kommentar erstellen
Mit dem Abschicken des Kommentars erklären sie sich mit der in der Datenschutzerklärung dargelegten Datenerhebung für Kommentare einverstanden. Spam, unangebrachte Werbung und andere unerwünschte Inhalte werden entfernt. Das Abonnieren via E-Mail ist nur für E-Mail Adressen erlaubt die Sie rechtmäßig administrieren. Widerrechtliche Abonnements werden entfernt.