3 min de lectura

Las revisiones de código son esenciales en el trabajo en equipo para asegurar la calidad del código y detectar errores de manera mas rápida.
En este video te doy 5 consejos que desde mi punto de vista te puedan ayudar a convertirte en un buen code reviewer.

Hoy vamos a hablar acerca de las revisiones de código y 5 consejos para convertirte en un buen code reviewer

¿Qué son las revisiones de código?

Un code review o revision de código es una técnica aplicada dentro de los equipos de trabajo para asegurar la calidad del código y reducir la cantidad de errores.

¿Quién hace un code review?

Cualquier programador debe ser capaz de realizar una revisión de codigo, sin embargo el valor obtenido cambia si la revisión la hace un programador junior o si la hace un programador senior.

Cuando la revisión la hace un programador senior ayudará a encontrar mejores maneras de hacer las cosas o detectar errores que pueden estarse inyectando.

Si la revision la hace un programador junior eso le ayudará a encontrar maneras inteligentes, claras y concisas de resolver problemas.

¿Qué se revisa del codigo?

• Que se apliquen los estandares definidos.
• Que se tenga una lógica concisa y que el código sea fácil de leer
• Que se aplique una solución real para el problema en cuestión

Consejo 1 para ser un buen code reviewer: Entender el problema

Hay que leer el ticket en cuestion, entender lo que se intenta solucionar y la solucion en si.

Si no se tiene claro el problema y la solucion, al leer el codigo se esta haciendo una revision a ciegas.

Es muy diferente leer el codigo que leer una descripcion en castellano de lo que se quiere aplicar como solución.

Me ha ocurrido leer que la solucion es aplicar una condicional y al final terminando haciendo otra cosa muy distinta en el codigo.

Consejo 2 para ser un buen code reviewer: Entender tu lugar

• Eres una persona al igual que quien genero el codigo.
• Estas evaluando el codigo y no a la persona.
• Tu revision ayudará a que la persona escriba mejor codigo.
• NO ES UN REGAÑO, ES UN PROCESO DE MEJORA

Consejo 3 para ser un buen code reviewer: Entender el beneficio del cambio

Al solicitar un cambio siempre siempre siempre te debes preguntar:

¿Por que esto se debió hacer diferente?

Y algo aun mas importante debes poder explicarlo de manera sencilla

En una ocasion alguien queria que se cambiara el nombre de una variable pero no podia explicar la razon.

Debes poder explicar claramente y en una corta frase que los nombres de variables son importantes para disminuir la friccion de nuevos developers en el proyecto y para claridad.

Consejo 4 para ser un buen code reviewer: Comentarios claros

Escribe comentarios claros

Que esta mal, porque esta mal, deja informacion para leer al respecto y da opciones de como se puede hacer mejor.

Mientras mas extenso y claro sea tu comentario, mejor sera tu revision

Un comentario siempre debe tener:

• Por que algo esta mal o se debe cambiar y como se puede hacer mejor
• Enlaces a Documentacion donde se describe el porque se deberia hacer distinto y como
• Y los mas importante: EVITAR LENGUAJE AGRESIVO

Consejo 5 para ser un buen code reviewer: Mantente disponible

Ofrece tu tiempo, ayuda y conocimientos para que los cambios solicitados se apliquen y que el programador pueda aprender.

Happy code reviewing

Con estos 5 consejos podras mejorar mucho como code reviewer, aplicalos.

Si nunca te ha tocado hacer un review, nunca es tarde, puedes comenzar a hacerlo desde ya, no necesitas ser asignado.