Kommentare zu: Bessere Kommentare für eure PHP-Skripte

Von: Robert Curth

Robert Curth — Tue, 20 Sep 2011 13:20:35 +0000

Das ist denke ich nur falsch angekommen – ich habe den Artikel gestern Abend etwas überarbeitet, da ich Dir vollkommen recht geben muss – er war schon ziemlich merkwürdig und überheblich geschrieben.

Wahrscheinlich muss ich damals irgendwann gemerkt haben, dass mir nichts weiter einfällt und auf absenden gedrückt haben.

Ich habe da tatsächlich ein paar Tricks auf Lager, was Namen angeht – allerdings die meisten schamlos geklaut aus “Robert Martin’s” Clean Code (das ich dir übrigens unbedingt als Lektüre empfehle, falls Du noch keinen Blick hineingeworfen hast)

Von: Noeppes

Noeppes — Mon, 19 Sep 2011 20:37:41 +0000

So böse war es aber nicht gemeint.
Natürlich mache auch ich Fehler.
Was ist denn bitte ein “lieber Troll”? Aber egal.

Sinnvolle Kommentare sind nur ein Teil des Scripts. Sinnvolle Namensgebung für Konstanten, Variablen, Funktionen, Klassen, Objekte… ist mindestens genauso wichtig.
Ich befasse mich erst seit einigen Monaten intensiv mit PHP/HTML/CSS… und vermisse eine mehr oder weniger verbindliche Form. Besonders die Namensgebung ist oftmals bei fremden Scripten eine Herausforderung.
Kommt denn mal ein Artikel mit dem du deine Vorgehensweise darlegst? Hier habe ich bisher nichts gefunden.
Den phpDocumentor werde ich mir dahingehend aber auch ansehen.

Bis dann
Der “liebe Troll”

Von: Robert Curth

Robert Curth — Mon, 19 Sep 2011 16:54:22 +0000

Im Rückblick sicher nicht einer meiner besten Artikel. Ich war damals noch nicht gut genug, um meine eigene Unfähigkeit gut einschätzen zu können.

Bevor Du andererseits über meine Orthografie herziehst – erkläre mir doch bitte was “außern” heißt

Von: Noeppes

Noeppes — Mon, 19 Sep 2011 16:43:07 +0000

…und wenn ich sehe wie viele Rechtschreibfehler die selbsternannten PHP-Profis der deutschen Sprache in deren Blogs antun…

Bevor man mit seinen Fingern auf andere zeigt sollte man doch schon dafür sorgen das man sich richtig und möglichst fehlerfrei außern kann. Auch für die deutsche Rechtschreibung gibt es Regeln.

Von: Rocu

Rocu — Thu, 09 Apr 2009 06:50:57 +0000

@Quix0r Das ist ja nun Code aus Piwik (nicht mein eigener) und es ging mir eher darum das Augenmerk auf die Kommentare zu legen

Underscores in Methoden und Klassennamen sind meiner Ansicht nach ok solange man ein System befolgt.

Von: Quix0r

Quix0r — Wed, 08 Apr 2009 17:37:18 +0000

Interfaces sollen mit “able” enden. Keinen Unterscore! Sondern so z.B. Throwable, Serializeable. Und Doxygen macht schoenere Doku, auch aus PHP-Code! Beispiel hier: http://docs.ship-simu.org

Das mit den Underscores in Methoden-, Klassen und Interface-Namen ist auch so eine “Unsauberheit” die in PHP vorherrscht. Bitte mich nicht falsch verstehen. Ich programmiere unheimlich gerne PHP, mache aber seit einigen Monaten es anders, und zwar komplett OOP und alles schoen nach Kamelschreibweise, bzw. ungarische…