Primero que todo muchas gracias x leer el post.
Eventualmente me siento muy disconforme con mi conocimiento como programador, a pesar q yo siempre intento superarme. Me pasa muy seguido que me nombran tecnologias y terminos q no comprendo, leo muchos codigos que no entiendo, o peoor inclusive leo codigo q hice yo mismo y paso considerable tiempo para volver a comprenderlo.
Nose si esto es gral y compartido x todos los programadores o solo es un rasgo mio...
Perdon x el tema del post se q no tiene nada q ver !
A todos nos pasa lo mismo, no te preocupes, sin embargo debes de tener muy en cuenta la documentación, si vas a programas cosas algo complicadas debes por lo menos escribir algunos comentarios de qué es lo que hace esa parte de código, unas ligeras líneas o incluso sólo una línea.
Ahora, la parte intricada podría ayudarse a explicar así misma sólo por los identificadores, lo cual es también de mucha importancia, si estás en Java sigue la notación "camelcase", ejemplo:
int numeroResultadosAfiliacion = 0;
Es preferible que utilices identificadores largos a que los cortes y pierdan algo de su significado.
Otra cosa son los javadoc, es una potente herramienta para documentar, aprende a utilizarla.
Saludos.