Leggo sul sito di un software "opensource" (un po' a modo suo, ma onore al merito, il software pare abbia un certo successo): 

Non vi aspettate del codice commentato in ogni sua parte. Di solito i commenti li metto soltanto dove servono a me, e d'altronde non ho messo online questi sorgenti affinché qualcuno potesse imparare a programmare.

Non ho guardato i sorgenti in questione, ma mi soffermo su questa frase. Mi fa venire in mente che in 60 anni non siamo andati molto avanti: le raccomandazioni a commentare il proprio codice non sono mai abbastanza, i programmatori vanno costretti: inutile sperare che si convincano da soli che commentare il proprio codice serve.

In questi giorni la mia concentrazione e il mio tempo lavorativo sono tutti occupati dall'implementazione in C++ di un software che deve gestire un controllo RTF con dentro degli oggetti (OLE) dell'applicazione stessa. È uno sforzo sovraumano. Vado in starving di risorse. Quando arrivo a casa sono poco altro che un IUnknown e mi ritrovo a fare stancamente AddRef() e subito Release() su tutto quello che mi capita a tiro, senza trovare nulla che mi soddisfi.

Per "aiutarmi" mi sono fatto comprare Essential COM di Don Box, un riferimento assolutamente essenziale per comprendere la filosofia alla base di COM e quindi di OLE. Purtroppo non sempre la filosofia basta da sola ma almeno ho fatto luce su alcuni aspetti oscuri. Ora resta solo l'altro 90% del lavoro. :)