Revisión de código: por qué la necesita el dueño de una web o una app

Usted tiene una web, una tienda en línea o una pequeña app. Alguien escribió el código: un contratista, un amigo, una agencia que ya no está o usted mismo tras unos cuantos fines de semana de tutoriales. Funciona, casi siempre. Pero no sabe si es sólido o si se sostiene con cinta adhesiva. Una revisión de código es una segunda mirada de alguien que no lo escribió, y responde a esa pregunta antes de que un problema pequeño se convierta en uno caro.

Cuándo compensa una revisión

• Antes de pagar un trabajo terminado. Una revisión muestra si el código recibido es razonable o está lleno de atajos.
• Cuando se hace cargo de un proyecto. El código heredado sin documentación es una caja negra hasta que alguien lo explica.
• Cuando algo se rompe una y otra vez. Un formulario que a veces falla, una página lenta, un error que vuelve después de cada arreglo.
• Antes de un lanzamiento o de una gran campaña de ventas, cuando un fallo cuesta dinero de verdad.
• Cuando escribe código usted mismo y quiere saber qué hacer mejor.

Qué encuentra una revisión

Quien revisa lee el código línea a línea y busca:

• Fallos: lógica que falla en algunos casos, como un carrito vacío, una fecha a final de mes o un nombre con apóstrofo.
• Puntos de riesgo: contraseñas escritas en el código, datos de usuarios usados sin comprobar, mensajes de error que revelan demasiado.
• Puntos débiles: código que funciona hoy pero fallará cuando crezca el tráfico o se actualice una librería.
• Legibilidad: nombres poco claros, funciones largas y código repetido que hacen cada cambio futuro más lento y más caro.

Los problemas se ordenan por importancia, para que sepa qué arreglar primero y qué puede esperar.

Qué no hace una revisión

Una revisión lee y explica el código; no lo ejecuta en su servidor ni prueba su web en producción. No es una auditoría de seguridad completa ni una prueba de carga. Tome las correcciones sugeridas como propuestas: quien mantenga el proyecto debe probar cada una antes de publicarla.

Cómo elegir qué enviar

Rara vez hace falta la web entera. Elija las partes que más importan:

• Donde se mueve el dinero: el pago, los precios y los descuentos.
• Donde los usuarios escriben algo: formularios de registro, de inicio de sesión, de contacto y de búsqueda.
• Donde está el problema: el archivo o la función que hay detrás del error que ve.

Unos cientos de líneas del sitio adecuado dicen más que miles de líneas de todo.

Cómo preparar el código

• Quite los secretos. Sustituya contraseñas, claves de API y datos de clientes por marcadores como PASSWORD_HERE.
• Indique el lenguaje y la versión, por ejemplo PHP 8 o JavaScript con React.
• Describa qué debe hacer el código en una o dos frases sencillas.
• Copie el mensaje de error exacto, si lo hay, completo.
• Diga en qué centrarse: el fallo, la velocidad, la legibilidad o los puntos de riesgo.

Cómo aprovechar el resultado

Comparta la revisión con quien mantenga el código y acuerden el orden de las correcciones, empezando por las críticas. Si usted no es técnico, el resumen en lenguaje sencillo le ayuda a hacer las preguntas adecuadas y a valorar las respuestas.

En resumen

Una revisión de código es una mirada independiente que encuentra fallos, puntos de riesgo y puntos débiles antes que sus clientes. Si quiere una, encargue una revisión de código: pega hasta 100, 400 o 1000 líneas y describe qué falla, y recibe una explicación por escrito de lo que hace el código, una lista de problemas ordenados por importancia y fragmentos corregidos para probar en su propio proyecto. El pago se libera solo después de que usted acepte el trabajo.