[archimedes] Re: AW: Re: Fragen zu Symbolen
- From: Joerg Niggemeyer <beagle@xxxxxxxx>
- To: archimedes@xxxxxxxxxxxxx
- Date: Mon, 15 Feb 2016 09:25:09 +0200
In message <c6um0bj43464e3mppahtfbd5.1455490364938@xxxxxxxxxxxxxxxxx>
Uwe <uwe@xxxxxxxxxxxxxxx> wrote:
Ich finde es sollten zumindest so viele Kommentare im Quelltext sein
dass man das Programm in 5Jahren selbst wieder lesen kann und
versteht.. Und das ist manchmal gar nicht so einfach ;-)
Man muss wohl auch stark unterscheiden für wen die Kommentare gedacht
sind. Ich persönlich neige dazu, lieber für mich selbst etwas mehr zu
kommentieren, insbesondere auch, als todo bzw. History oder Effekt auf
das PRG.
Falls andere das zu Lesen bekommen sollten, kann es wohl sein, dass es
zu Verwirrungen führen könnte bzw. zu Lästereien.....
Wahrscheinlich lassen deswegen viele in öffentlichen PRGs ihre
Kommentare weg, um nicht als vermeintlicher Kleingeist dazustehen.
Ein Todo ist für mich z.B. noch herauszufinden, warum in Basic TRUE -1
ist. Finde ich typisch Britisch, würde jedoch vermuten, dass die
Gründe entweder aus dem OS heraus kommen oder mit der ARM Hardware
zutun haben?
Persönlich finde ich diesen Umstand mit -1 sehr nervig, da ich es
effektiver finde False = 0 und TRUE >=1 zu programmieren.
Volle Zustimmung und auch sonst können gute Kommentare die Analyse in die
richtige Richtung lenken. Programme, die man einfach so runter liest, haben
i.d.R. "Hello World"-Niveau. Komplexe und auch trickreiche Programme sind
keine Schande ganz im Gegenteil, man sollte sie aber warten können und dazu
sind gute Kommentare (d.h. nicht "i um einen erhöhen") hilfreich.
Man bedenke, dass Kommentare für das perfekte System ebenfalls weniger
wichtig sind, jedoch für Fehlerbehandlungen IMHO einfach ein Muss
sind. Falls eine Hardware oder SW ein fehlerhaftes Modul besitzt und
man einen Workarround deswegen macht, der eben nicht einem sonst
vielleicht üblichen Standard entspricht, so ist ohne einen Kommentar
bzw. Referenzierung auf diesen Fehler es einem Anderen(Neueinsteiger)
kaum möglich, dieses nachvollziehen zu können?!?!
Dann einen schönen Start in die Woche !
--
Joerg Niggemeyer
Other related posts: