/* no comment */
Wer nichts zu sagen hat, sollte einfach mal die Fresse halten. Oder keinen Kommentar hinterlassen, zum Zeugnis des eigenen Unvermögens. Im besten Fall sollte jede/r selbsternannte Programmierer/in respektive aus- oder eingebildete Softwareentwickler natürlich selbsterklärenden Code schreiben. Das aber ist längst nicht immer und überall der Fall, insofern kann man froh sein wenn der hingekrakelte Quelltext oder aber der Kommentar halbwegs verständlich ist, oder zumindest unterhaltsam. Ganze Blogs kümmern sich um eben jene im Grund völlig überflüssigen und dennoch in nicht-öffentlichem Code leider allzu oft aufzufindendem digitalen Nonsens. Ich habe hier mal meine persönliche "Best of" zusammengestellt, und werde sie bei sich bietender Gelegenheit aktualisieren:
/* DO/DON'T DO THIS, THAT OR DO/DON'T CHANGE THIS */insbesondere in dieser aufdringlichen Form, an der man in jedwedem Editor, vom vi bishin zu Visual Studio 2010, beim besten Willen nicht vorbei kommt. Cool besonders dann, wenn sich bei syntaktischer Analyse herausstellt, das der "DO NOT REMOVE THIS!" markiete Codeabschnitt völlig überflüssig ist, entweder weil er durch andere Programmteile ganz oder in Teilen ersetzt werden könnte, oder noch einfacher: Wenn er schlicht und ergreifend nie aufgerufen wird.
/* WHO MADE THIS CRAPPY/SILLY/DUMB/... CODE!? */gerade dann wenn der bemängelte Abschnitt nur wenige Zeilen umfasst die ein ach so kundiger Ingenieur mit deratigem Mitteilungsbedürfnis jederzeit im nu in ein Nobellpreis-verdächtigen Mehrwert verwandeln würde, noch vor dem ersten Kaffee
METHODWITHUSELESSNAME(ARGUMENT LIKE ARG1, VALUE2, etc.)sind vor allem bei Autoren beliebt, deren gesamter Quelltext oder Teile dessen aus Suchmaschinen stammen und denen es zu viel Mühe bereitete den so übernommenen Code wenigstens noch mit sachgerechten Namen zu versehen.
/* destructor / constructor */Tatsächlich gibt es Programmierer und Softwareentwickler - insbesondere selbsternannte, dann in der Regel auch: selbsternannte Gurus ihres Fachs - die es für nötig halten jeden einzelnen Konstruktur als solchen zu kennzeichnen, und zwar nur so.
Mein Ziel ist es nicht, mit dieser Aufzählung jemand anzugreifen, sondern vielmehr für das Thema sinnloser Kommentare zu sensibilisieren. Da hilft meist Humor, und Selbstironie: Programmierer lernen nämlich nie aus, und wer über sich selbst lachen kann, tut das meist über eine vorangegangene Inkarnation. Wer hingegen immer auf dem selben Stand bleibt, ohne diese Ratschläge ernst zu nehmen, ist früher oder später überflüssig.
Labels: Beobachtungen
