wenn selbst Membervariablen kommentiert sind, ist das ein Indiz für den Einsatz eines Doku-Generators, der die speziell formatierten Kommentare auswertet und daraus eine technische Dokumentation generiert.

Einen Konstruktor mit “Konstruktor” zu kommentieren, zeugt wirklich nicht von geistiger Größe ;) Aber es soll auch dem einen oder anderen Profientwickler schon passiert sein…

Meist bin ich übrigens der meinung, dass eher die kleinsten Funktionen die größsten Kommentare benötigen, weil oft mehr im Hintergrund implizit passiert, als kommentiert ist.

auch muss nicht jede mini variable sofort kommentiert werden. was ist an $sorting so unverständlich das ich noch dabei schreiben muss “Gibt die art der sortierung an”. das einzigste was ich hier erwarten würde, wäre eine werte tabelle ala “TRUE = Aufsteigend Sortieren, FALSE = Absteigend sortieren”. gibts aber nirgends. auch steht bei jedem 2. script “__construct() - konstruiert das object”…..sowas entferne ich mit genuss….

das allerwichstigste ist, wie du ja sagst, aussagekräftige namen _OHNE_ abkürzungen zu nehmen und eine übersicht (am besten außerhalb des codes) zu schaffen, wann was aufgerufen und was gemacht wird….