Es gibt immer und überall Menschen die die Sache nicht so ernst nehmen wie andere. Ob auf Arbeit, beim Fußball oder im Videospiel. Ich habe mich damit abgefunden, dass man öfter auf solche Menschen trifft und bin mir bewusst, dass ich auch manchmal der Bremser bin wenn ich z.B. sage "ach, ich spiel mal eine Runde 'Trink-DotA' und geb mir nach jedem Death einen Kurzen." (es gibt sicher auch Beispiele mit weniger Vorsatz).
Für die die engagiert dabei sind ist das ärgerlich, aber so ist es halt.
Zum Dokumenationsthema:
Wenn ich wissen will was passiert wenn ich den blauen Button drücke, möchte ich nicht im Code nachsehen müssen um den Programmablauf zu verfolgen. Das sollte schon irgendwo in einer Dokumentation geschrieben stehen.
Wenn ich wissen will wie etwas implementiert ist, dann sehe ich in den Code. Und da halte ich es auch so wie schon genannt wurde:
möglichst sinnvolle Bezeichnungen für Klassen, Methoden und Variablen
möglichst explizite Schreibweise (Klammern setzen anstatt sich auf die Operations-Reihenfolge zu verlassen)
DocBlocks (ist in PHP eh wichtig um den IDEs auf die Sprünge zu helfen)
extra Kommentare um "schwierige" Implementationen zu erklären (im Extremfall mit Namensnennung, damit der nächste evtl. einen Ansprechpartner hat ohne erst im VCS zu suchen)