Cómo ofrecer comentarios técnicos de alto impacto usando Loom

Graba comentarios técnicos claros y prácticos con Loom

Los comentarios escritos tienen sus limitaciones. Si quisieras explicar un error a través de un mensaje de Slack, podrías necesitar escribir cinco párrafos. Sin embargo, solo te llevaría 30 segundos mostrar ese mismo error directamente en pantalla. Los comentarios de revisión de código pueden carecer del contexto circundante que los hace útiles. Mientras tanto, cuando los equipos están distribuidos, esperar una reunión síncrona para revisar una incidencia hace que todo se ralentice.

Loom te ofrece una mejor opción. En lugar de escribir bloques largos de texto o programar una reunión cada vez que hay que revisar algo, puedes grabar tu pantalla, explicar el problema mientras lo muestras y compartirla con tu equipo cuando mejor le venga. Los comentarios técnicos se vuelven más claros porque quienes los ven pueden ver exactamente lo que tú ves, como la línea específica de código, el error de la interfaz de usuario o el flujo de trabajo que falla en determinadas circunstancias.

Este enfoque funciona bien ya sea que estés revisando una solicitud de extracción, señalando una preocupación de la experiencia de usuario, proporcionando comentarios constructivos sobre una decisión de arquitectura o auditando un proceso de implementación. El recorrido visual elimina las conjeturas y les da a tus compañeros de equipo todo lo que necesitan para tomar medidas.

Sigue leyendo para aprender a planificar, grabar y compartir comentarios técnicos de alto impacto en Loom.

Paso 1. Define el objetivo de tus comentarios técnicos

Antes de abrir Loom, ten claro qué estás revisando realmente y qué resultado buscas. Hay una gran diferencia entre marcar un problema cosmético en un flujo de interfaz de usuario y recomendar una refactorización completa de un servicio de backend. Si no defines el alcance desde el principio, tu grabación será menos clara y quienes la vean no sabrán qué priorizar.

Aclara si estás viendo una función, una solicitud de extracción, un flujo de trabajo o un flujo de experiencia de usuario. Luego, identifica el resultado que quieres. ¿Estás solicitando que se corrija un error? ¿Sugieres una mejora de rendimiento? ¿Intentas lograr una coordinación interdisciplinar en una decisión de diseño? Indicar esto desde el principio le da a tu audiencia una razón para seguir viendo el vídeo.

También ayuda identificar el nivel de prioridad antes de grabar. Si tus comentarios técnicos son urgentes, menciónalo al principio. Si se trata de una sugerencia menos prioritaria para un sprint futuro, dilo. De esta manera, quienes vean el vídeo entenderán la urgencia incluso antes de empezar a reproducirlo.

Paso 2. Prepara tu entorno para obtener comentarios más claros

Una pantalla caótica se traduce en una grabación caótica. Cierra todas las pestañas, ventanas o aplicaciones que no estén relacionadas con los comentarios que vas a entregar. Silencia las notificaciones para que un ping aleatorio de Slack no interrumpa tu explicación a mitad de frase.

Haz zoom en las secciones relevantes del código, diseño o interfaz que planeas comentar. Por ejemplo, si estás revisando una solicitud de extracción, ten los cambios de código abiertos y desplázate hasta el lugar correcto. Si estás recorriendo un flujo de experiencia de usuario, carga el prototipo o el entorno de ensayo con anterioridad. Abre cualquier ticket, documentación o material de referencia que planees mencionar para que no tengas que buscar entre los marcadores mientras se ejecuta la grabación.

Este tipo de preparación solo toma unos minutos y le ahorra tiempo a todo el mundo. Tu grabación será más precisa y las personas que la estén viendo no tendrán que esperar mientras buscas el archivo correcto. También les muestra que te has esforzado para que su revisión sea lo más eficaz posible.

Paso 3. Estructura tu presentación antes de grabar para que el vídeo sea conciso

Un poco de planificación sirve para mucho. Antes de empezar a grabar, haz un resumen de los temas que vas a tratar usando un formato simple que incluya el contexto, la observación, el impacto y la recomendación.

Esto es lo que debes incluir en cada parte:

• Contexto: explica qué estás viendo y por qué lo estás revisando. Esto les proporciona a quienes ven la presentación los datos que necesitan antes de que te adentres en los detalles concretos.
• Observación: describe qué es lo que has visto, ya sea un error, alguna ineficacia o una brecha en el diseño.
• Impacto: explica por qué es importante y a qué afecta, como el rendimiento, la experiencia del usuario, la fiabilidad u otro aspecto.
• Recomendación: comparte tu sugerencia para resolver el problema o el siguiente paso para que quien vea el vídeo sepa exactamente qué medida tomar.

Decide el orden de las pantallas que vas a mostrar para que el recorrido tenga sentido. Si abordas varios problemas, agrúpalos de manera lógica en lugar de saltar entre archivos o páginas no relacionados. La comunicación asíncrona solo funciona cuando el mensaje está lo suficientemente organizado para que alguien pueda seguirlo cuando decida verlo.

Paso 4. Comienza a grabar en Loom usando la configuración correcta

Abre Loom y elige si quieres grabar solo la pantalla o la pantalla y la cámara. El modo "Solo pantalla" funciona bien para revisiones de código detalladas donde cada píxel del espacio de pantalla importa. Por su lado, el modo "Pantalla y cámara" añade un elemento personal y puede ayudar cuando tus comentarios técnicos implican un razonamiento matizado, ya que las expresiones faciales y el tono hacen que sea más fácil para quien revisa evaluar la intención.

Confirma que estás grabando la ventana o pestaña correcta. Suena obvio, pero compartir accidentalmente la pantalla incorrecta es más común de lo que la mayoría de las personas admite. Habilita el resaltado del cursor para que las personas que están viendo el vídeo puedan seguirte en todo momento. Prueba el audio con un clip rápido de 5 segundos para asegurarte de que tu micrófono se oiga bien.

Paso 5. Narra la grabación con claridad y haz una demostración en vivo

Una vez que estés grabando, habla a un ritmo constante y haz referencia a componentes, archivos o flujos de usuario específicos por nombre. Un lenguaje claro evita tener que aclarar dudas más adelante.

Muestra la incidencia en tiempo real. Si una función arroja un error bajo ciertas condiciones, desencadena ese error en pantalla. Si un elemento de diseño se rompe en un punto de ruptura concreto, cambia el tamaño de la ventana del navegador y deja que el usuario lo vea. Luego, explica exactamente qué cambio recomiendas y por qué es importante, ya sea una corrección de código, un ajuste de diseño o una actualización de proceso.

Este nivel de detalle es lo que hace que los comentarios técnicos en Loom sean más útiles que un comentario escrito. La persona que ve el contenido observa el problema, escucha tu análisis y comprende tu recomendación. De este modo, es más fácil tener reuniones productivas con Loom sin necesidad de programar una.

Paso 6. Añade comentarios con marca de tiempo para que tus comentarios sean procesables

Después de terminar de grabar, mira de nuevo la grabación e inserta comentarios en los momentos importantes del vídeo. Marca los puntos donde destacas una incidencia importante, sugieres un cambio o haces referencia a un ticket relacionado. Estos marcadores con indicación de tiempo permiten a los espectadores ir directamente a las secciones que más les interesan.

En caso de grabaciones más largas, resume las correcciones críticas por escrito en los comentarios de Loom o en el campo de descripción. De esta manera, los compañeros de equipo pueden revisar rápidamente los próximos pasos sin tener que volver a ver el vídeo completo, lo que resulta especialmente útil para equipos que practican actividad asíncrona con Loom en diferentes zonas horarias.

Paso 7. Comparte la grabación con los miembros del equipo apropiados con próximos pasos claros

Envía el Loom a las personas que deben tomar medidas al respecto. En tu mensaje, incluye un breve resumen de lo que abarca la grabación y qué acciones se requieren. No hagas que el espectador tenga que adivinar qué es lo que esperas de él.

Aclara las fechas límite, las responsabilidades y, si solicitas revisiones, una conversación o una aprobación. Si hay varias personas involucradas, especifica quién es responsable de cada parte. Este nivel de claridad ayuda a alinear a los equipos en torno a prioridades compartidas y evita la confusión sobre quién es responsable de qué, que es una de las principales razones por las que los ciclos de revisión se alargan.

Consejos para proporcionar comentarios técnicos constructivos

Los buenos comentarios técnicos son claros y directos, pero también mantienen intacta la relación de trabajo. La forma en que aportas comentarios importa tanto como el contenido en sí, especialmente cuando estás grabando algo que perdura y se puede volver a ver. Estos son algunos principios que tener en cuenta:

• Céntrate en la actividad, no en la persona: enmarca tus comentarios en torno a los resultados, el rendimiento o el impacto en el usuario en lugar de centrarte en las habilidades de alguien. Este enfoque respalda un mejor intercambio para los comentarios del equipo.
• Equilibra la crítica con el reconocimiento: destaca lo que está funcionando bien antes de profundizar en lo que hay que cambiar. Reconocer una actividad bien hecha genera confianza y hace que las críticas sean más fáciles de recibir. Además, le ofrece a tu equipo una idea más clara de lo que se considera un “buen” resultado para futuros proyectos.
• Especifica qué cambiarías y por qué: los comentarios imprecisos obligan al espectador a interpretar tu intención. Nombra el componente, comportamiento o resultado exacto que requiera atención y explica el razonamiento que hay tras la recomendación. Los equipos que invierten en una retroalimentación completa periódica desarrollan este hábito con el tiempo.