Al repecto del título, yo, por ejemplo afirmo que documentar es un coñazo, aunque hay veces que se hace realmente imprescindible. Estamos hablando de programación, no obstante, no se require conocimiento alguno para leerlo, mas que el hecho de saber inglés.

Oigo todos los lunes por la mañana a mi profesor de metodología de la programación exhortarme a confirmar que si alguien metiese variables "cosa" "caca" y comentarios raros o que esté mal documentado el Kernel Linux, todos se le echarían encima.

Bien, y sin embargo... se mueve.

He aquí la lista de los mejores comentarios que he encontrado, de momento:

1. drivers/net/sunmhe.c (Tarjetas Sun Happy Meal, con chip BigMac)(Este archivo deberiais mirarlo).
   
   • /* Welcome to Sun Microsystems, can I take your order please? */
     
   • /* Would you like fries with that? */
     
   • /* Anything else? */
     
   • /* Fifty-two cents is your change, have a nice day. */
     
   • /* We've tried everything. */
     
   • /* Anything interesting happen? */
     
   • /* Would you like to try our SMCC Delux? */
     
   • /* Lettuce, tomato, buggy hardware (no extra charge)? */
     
   • /* We have a special on GNU/Viking hardware bugs today. */
     
   • /* Don't forget your vik_1137125_wa. Have a nice day. */
     
   • /* We're consolidating our STB products, it's your lucky day. */
     
   • /* Come back next week when we are "Sun Microelectronics". */
     
   • /* Remember: "Different name, same old buggy as shit hardware." */
     
   • /* Only Sun can take such nice parts and fuck up the programming interface like this. Good job guys...
     
   
   
2. arch/sparc/kernel/ptrace.c
   
   • /* Fuck me gently with a chainsaw... */
     
   
   
3. drivers/char/rio/list.h
   
   • /* Will God see it within his heart to forgive us for this thing that we have created? */
   
   
4. lib/vsprintf.c:
   
   • /* vsprintf.c -- Lars Wirzenius & Linus Torvalds. */
     /* Wirzenius wrote this portably, Torvalds fucked it up :-) */
     
   
   
5. drivers/scsi/qlogicpti.h:
   
   • /* Am I fucking pedantic or what? */
     
   
   
6. drivers/scsi/esp.h:
   
   • /* The HME is the biggest piece of shit I have ever seen. */
     
   
   
7. drivers/char/watchdog/shwdt.c:
   
   • /* brain-damage, it's managed to fuck things up one step further.. */
     
   
   
8. arch/sparc/kernel/process.c:
   
   • /* fuck me plenty */
   
   

Ya paro, ya...