Jag använder alltid kommentarer och följer phpDoc , men till vis del formas kod efter humör. När jag är mer stressad och har mycket att tänka på är jag också mer benägen att dela upp koden med tydliga block skiljda åt av tomma rader och t.ex. /***************
Ett exempel:
Annars blir det mer kompakt. Egentligen tycker jag koden ska förklara sig själv men jag brukar följa upp med kommentarer i alla fall, dels för att följa phpDoc och kunna använda applikationen, men jag tycker också det är lite enklare att se koden i färgat skick om koden delas upp av kommentarernas färg. Det finns något för blicken att stanna upp vid.
Hur skriver du dina kommentarer?
Tips:
Sådana här saker är ett evigt diskussionsämne som kan rör upp oss nördar ;) Nedan hittar du några andras tankar om kommentering av koden. Söker du på forum eller Google Code Search hittar du säkert mycket mer.
Läsning