Skip to the content ForoHackers
Log inJoin

Revisión de código: por dónde empezar

Code review
#3358 · · Quote · Report

La revisión de código consiste en que otra persona distinta del autor lea un cambio antes de integrarlo. Detecta errores y problemas de diseño pronto, reparte el conocimiento del código y mantiene el estilo coherente. Bien hecha es una conversación sobre el código, nunca sobre la persona, y es una habilidad tanto de quien revisa como de quien escribe.

Conceptos clave

  • Cambios pequeños: una revisión de unos cientos de líneas recibe atención real; una enorme recibe un sello de goma.
  • Qué mirar: corrección, pruebas, diseño, nombres, seguridad y si el cambio hace lo que dice.
  • Automatizar el resto: formateadores, linters e integración continua se ocupan del estilo para que las personas piensen en el significado.
  • Tono: pregunta, explica el motivo, separa lo «obligatorio» de lo «menor» y elogia lo que está bien.
  • Deber del autor: describe el porqué, revisa tu propio diff primero y responde a los comentarios sin ponerte a la defensiva.

Vocabulario

  • Pull request: un cambio propuesto, con su discusión, antes de integrarse.
  • Nit: un comentario menor y opcional sobre estilo.
  • LGTM: «looks good to me», una aprobación.
  • Linter: una herramienta que señala código sospechoso o poco idiomático.

Qué estudiar, en orden

  1. Revisa tu propio diff línea a línea antes de pedírselo a nadie y anota lo que señalarías.
  2. Lee revisiones de un proyecto de código abierto bien llevado y fíjate en cómo se redactan.
  3. Escribe una lista de comprobación para tu lenguaje: manejo de errores, liberación de recursos, concurrencia, validación de entradas.
  4. Configura un formateador y un linter para que la lista se acorte.
  5. Practica revisar el diseño: ¿esto va aquí?, ¿lo entenderá la próxima persona?

Etiquetas relacionadas

#version-control #testing #open-source #secure-coding

You are not logged in, so this goes up anonymously: no account, no name and no address is stored with it, and it may carry no link and no image. Log in or join to post under your name. Our web server's logs keep the address and time of every request for up to 14 days; to keep yours out of them, use Tor. To reach the staff in confidence, use the drop. Sign as a returning source (a key kept only in this browser)

Sending takes a few seconds here: your browser first works out a proof of work against spam.

Reply