Cómo hacer Code Reviews

Los Code Reviews son una de las características más interesantes de 4Geeks.com. Le dan al mentor una herramienta rápida para poder revisar código, y al estudiante, una fuente adicional de feedback para mejorar como desarrollador. Un Code Review, como su nombre lo indica, no es más que un comentario con respecto a una porción de código. En este artículo analizaremos las características deseables que debe tener un Code Review para ser efectivo para el estudiante.

Empecemos por lo primero:

¿Cómo hacer un Code Review desde la plataforma de 4Geeks.com?

Paso 1: Selecciona un programa.

Si eres un mentor, tienes un dashboard donde puedes ver los distintos programas o cohorts en los que estás. El primer paso para hacer un Code Review es entrar en alguno de estos programas.

Paso 2: Ve al apartado de Assignments

Necesitas hacerle Code Reviews a alguna entrega de un estudiante, así que dirígete a ese apartado.

Paso 3: Selecciona la vista de proyectos

Paso 4: Selecciona un proyecto

Los proyectos disponibles para Code Review son los entregados, estos aparecerán con un botón azul y el texto "Review" dentro del mismo. Presiona ese botón.

Paso 5: Empieza a hacer Code Reviews

Si el proyecto no tiene al menos 3 Code Reviews, no puede ser marcado como Aprobado o Rechazado. Presiona el botón "Start code review" para empezar a hacer Code Reviews.

Paso 6: Selecciona el Commitfile que quieres revisar

Un commitfile es un archivo modificado por un estudiante en un commit en particular. Por defecto, Rigobot analiza los tres últimos commits de un repositorio, y según el Committer de interés, extrae los archivos necesarios en cada commit. Los commitfiles son una de las partes fundamentales del Code Review, es bueno saber el uso de ese archivo en el proyecto que estés revisando para que la review tenga más sentido.

¿Qué significa cada ítem de la modal de Commitfiles? File: Es el archivo modificado por un estudiante en un commit. Feedback status: Nos da información sobre si el estudiante ya revisó y calificó el Code Review o no. Reviews: El número de Code Reviews que tiene cada archivo.

Selecciona un Commitfile con el botón: Start Review.

Paso 7: Selecciona una porción de código del Commitfile

Cuando selecciones un Commitfile se mostrará una modal con el código de ese archivo en particular, puedes seleccionar las líneas que quieras comentar, luego presiona el botón azul para iniciar el Code Review.

Sugerencia: Revisa primero todo el código, así puedes saber exactamente dónde el código tiene fallas o mejoras posibles antes de ir y seleccionar cualquier parte que te parezca mejorable, los archivos suelen tener un sentido y este sentido es importante para dar reviews de calidad.

Paso 8: Escribe el comentario.

Comentar el Code Review es quizás la parte más importante. Más adelante vas a encontrar una guía de puntos a tener en cuenta para escribir un Code Review de calidad. Luego de escribir un comentario de calidad, presiona el botón de Submit y habrás hecho tu primer Code Review.