Reviso pull requests de proyectos libres desde hace años y esto es lo que más me ha funcionado:
- Empieza por lo bueno que haya, de verdad y concreto. No como adorno antes del "pero".
- Pregunta antes de afirmar. "¿Esta función puede recibir
None?" abre una conversación. "Esto está mal" la cierra. - Separa lo que bloquea de lo que no. Como decía tabs_over_spaces_42 hace tiempo, un prefijo
nit:para lo opcional ahorra malentendidos. - Propón código cuando sea corto. Una sugerencia que se puede aceptar con un clic vale más que un párrafo de descripción.
- No comentes lo que decide una herramienta. Si el formateador lo arregla, que lo arregle el formateador.
- Recuerda quién está al otro lado. En el software libre mucha gente manda su primer PR con miedo, y una mala review puede ser la última.
Y si un PR es enorme, pide que se divida antes de revisar. Nadie revisa bien 2000 líneas.