Q: Wat is eigenlijk het devies met commentaar?
Op dit moment ben ik met nog een aantal mensen bezig aan een project en daar komt op zich alleen het hoogstnoodzakelijke commentaar in voor. Iedereen die erbij betrokken is kan de huidige code zo lezen en schrijven, hier is heel weinig geen commentaar voor nodig.
Nu hebben we een nieuwe aanwinst bij ons project en die kan de code niet lezen en schrijven. Hij vraagt dan ook om meer commentaar, alleen voor de huidige proggers is het gewoon duidelijk...
Net zoals je aan een wiskundige geen stelling van pythagoras hoeft uit te leggen, aan een C-progger geen pointers hoeft uit te leggen, volstaat onze huidige commentaar vorm goed voor de huidige proggers.
Nu is de vraag, zijn er regels wat er wel / niet gecommentariseerd moet worden of is dit meer een groepsgevoel?
Want ik gok dat als de nieuwe progger in dit topic code gaat posten ( nadat hij nederlands geleerd heeft

) dat velen het met hem eens zouden zijn dat het slechte code betreft, maar de huidige proggers snappen het 100%, wij zijn ook best bereid om wat meer commentaar te schrijven, maar we gaan niet elke regel becommentariseren...
offtopic:
Het betreft hier geen bedrijf, maar een OpenSource programma. Wij zijn dus blij met ongeveer elke extra progger, keiharde kenniseisen zijn dus ook niet echt te stellen