edición general

Construyendo un cliente de BitTorrent completo en Go [ENG]

#30 Completamente de acuerdo. Recomiendo la lectura de uncle Bob en su libro de prácticas sobre Clean Code.
#37 Un buen código de debe autodescribir. Comentarios que explican lo que hace un trozo de código pueden implicar "un problema". Además después tenemos otro problema: hay que mantener el código Y los comentarios doble trabajo y doble posibilidad de error sobre todo si pasa por 5 manos distintas.
Igualmente en otros casos concretos si veo necesario poner ejemplos en código. Una regular expression por poner un ejemplo muy concteto aunque es aplicable a otros casos. Depende del uso. Siempre hay que aplicar la lógica y filosofía KISS. En mi experiencia es lo que mejores resultados ha dado.
Saludos.
#42 En assembler es el típico ejemplo de lenguaje de bajo nivel que como bien comentas sin comentarios estás muerto.
El resto como decía depende del contexto. Un i++ dentro de un bucle puede ser nada o bien siguiente estrella como mencionas, con lo cual el sentido del comentario cambia en función de la semántica. Uno es relevante y otro no en el caso de un bucle.
Creo que en el fondo del asunto estamos de acuerdo.
#42 Y haciendo una breve puntualización: Sí i++ es siguiente estrella entonces lo mejor es llamar a esa variable siguienteEstrella y ya está.

menéame