Conductual (STAR)Senior

Cómo responder “How do you document your work?” en una entrevista en inglés

How do you document your work?

Responde con dos niveles y artefactos concretos. Día a día: la descripción del PR lleva el porqué — qué problema resuelve y qué descartaste — porque es lo que alguien leerá seis meses después. Para lo grande: un design doc corto antes de empezar, actualizado cuando la realidad no coincide. Y una regla honesta: no escribir documentación que nadie lee.

Respuesta modelo en inglés

Two levels. Day to day, the PR description carries the why — what problem it solves and what I ruled out — because that's what someone reads six months later. For anything bigger, I write a short design doc before I start and update it when reality disagrees with it. I try not to write docs nobody reads: if a README goes stale twice, that's a sign it should've been a test or a script.

Nivel B1-B2: pensada para que la adaptes a tu experiencia, no para memorizarla palabra por palabra. Cambia el stack, los años y el contexto por los tuyos.

Frases clave que merece la pena memorizar

  • the PR description carries the why
  • I write a short design doc before I start
  • I try not to write docs nobody reads

Por qué te hacen esta pregunta

En un equipo distribuido, tu documentación es tu presencia cuando no estás conectado. Esta pregunta no va de ser ordenado: va de si el equipo puede avanzar sin ti a las tres de la mañana de su huso horario. El filtro oculto es el inglés escrito en su versión más exigente, que es dejar clara una decisión técnica en tu segundo idioma. Alguien que resuelve cualquier cosa pero deja PRs con “fix bug” genera trabajo para los demás, y en remoto eso se paga caro y se detecta rápido.

Errores típicos de hispanohablantes

  • Decir “documentations”. Es incontable: “documentation” o “the docs”.
  • Dejar títulos de PR vacíos (“fix bug”, “changes”). Ese título es inglés escrito evaluable: “Fix race condition in the payment webhook”.
  • Traducir “actualizar el documento” como “actualize the document”. Es “update”.
  • Decir “let me explain you”. No existe: es “let me explain it to you” o “let me walk you through it”.
  • Responder solo “I write comments in the code”. Los comentarios no documentan decisiones: nombra PR descriptions, design docs, ADRs o runbooks.

En resumen: Documentar en remoto es parte del trabajo, no un extra. Nombra artefactos concretos: PR description, design doc, ADR, runbook. Y “documentación” es “documentation”, incontable — “documentations” no existe.

También te la pueden hacer así

  • What's your documentation process like on a remote team?
  • What's your approach to technical documentation?
  • How do you write a good pull request description?
  • How do you make sure your team can pick up your work?

Leerla no es lo mismo que decirla

Esta pregunta se responde en voz alta y bajo presión. En DevLingo la ensayas con un tutor IA que hace de entrevistador y te corrige la frase concreta que dijiste mal, no un listado genérico de errores.

Ensayar esta pregunta gratis

Otras preguntas de conductual (star)

Todas las preguntas de entrevista·Glosario de inglés técnico

Cómo responder “How do you document your work?” en una entrevista en inglés — DevLingo