Escribir claro no es escribir elegante. Es escribir de modo que una persona ocupada entienda el punto, decida y actúe sin tener que llamarte. Deja de intentar sonar profesional. La niebla corporativa no es autoridad; es trabajo que le pasas al lector. Esta guía muestra las ediciones que uso en correos, propuestas y documentos técnicos cuando el primer borrador no está haciendo su trabajo.
🎙️ Publicado y grabado: ·
Antes de escribir, termina dos frases: «El lector es…» y «Después de leer, debería…». Si la segunda respuesta es «estar informado», no has tomado una decisión. ¿Necesita aprobar, arreglar, comparar, prepararse o recordar? Un documento puede servir a varios lectores, pero un párrafo no puede servir a cinco propósitos a la vez.
Weak brief
Audience: stakeholders
Goal: provide an update
Usable brief
Reader: Maya, who owns the launch decision
Action: approve the two-day delay by 3 p.m. Thursday
Evidence she needs: failed load test, repair estimate, customer impactUn líder de proyecto escribió: «Solo comparto la última presentación para visibilidad». Nadie respondió. El viernes preguntó por qué legal no la había aprobado. La petición nunca había aparecido. Arréglalo en tres pasadas. Nombra a legal como lector. Pon «Aprobar la diapositiva 12» en la primera línea. Agrega el plazo y qué pasa después de la aprobación. No culpes al lector por no descubrir una tarea escondida.
En el trabajo, el suspenso casi siempre es una descortesía. Di la respuesta, después el motivo, después el detalle. Un jefe no debería leer seis párrafos para saber si el lanzamiento va a tiempo. Escribir empezando por los antecedentes se siente seguro porque retrasa el compromiso. Borra esa pista de despegue.
Before
Over the past several weeks, the team has been evaluating a number
of vendors while also considering our changing operational needs.
Following those discussions, we wanted to share an update.
After
Choose Northstar. It is the only vendor that meets our June deadline
and audit requirement. It costs $8,000 more per year.
Decision needed: approve Northstar by Tuesday at noon.
Evidence: comparison table below.Usa la primera frase como prueba. Si el lector solo ve esa frase en una notificación del teléfono, ¿sabrá cuál es el punto? «Actualización rápida» no es un punto. «La migración se retrasa dos días» sí lo es.
Reemplaza los elogios, las preocupaciones y las magnitudes vagas por hechos observables. «Significativo», «pronto», «optimizar» y «varios» obligan al lector a adivinar. Los números sirven solo cuando responden la pregunta del lector. «La conversión mejoró 4,2 por ciento» sigue estando incompleto si el lector necesita saber las fechas y la línea base.
Vague Concrete
We had several incidents. Checkout failed 17 times on Monday.
Please respond soon. Reply by 2 p.m. Friday.
The page is much faster. Median load time fell from 3.1s to 1.4s.
We should optimize onboarding. Remove the card step from trial signup.
A large group dislikes it. 8 of 12 interviewees could not find Save.Si no sabes el número, di qué observaste y qué tan limitada es la evidencia. Escribe: «Tres llamadas de soporte esta semana mencionaron facturas duplicadas». No lo asciendas a «Los clientes están ampliamente insatisfechos». La escritura clara deja la evidencia débil a la vista en lugar de decorarla.
Lo corto no es automáticamente claro. Una fila de frases minúsculas puede sonar infantil. La regla útil es una afirmación principal por frase, con suficiente detalle para entenderla. Cuando una frase contiene tres cláusulas con «y», un paréntesis y una excepción al final, pártela. Pon la excepción junto a la afirmación que modifica.
Before: 54 words
We reviewed the rollout plan and, given the staffing constraints that
were discussed last week and the fact that the mobile build remains
in review, which may be resolved by Wednesday, we believe it would be
appropriate to move the launch, although the web release could still
proceed if leadership prefers.
After
Move the full launch from Tuesday to Thursday. The mobile build is
still in review, and support has two people out. We can release the
web version on Tuesday, but I recommend one coordinated launch.Lee el borrador en voz alta. Si necesitas volver a empezar una frase, al lector probablemente le pase lo mismo. Conserva la redacción si es larga pero fácil de seguir. Córtala si la gramática está escondiendo la decisión.
Un párrafo útil tiene un punto, una prueba y una consecuencia. Pon la afirmación primero. Mantén la evidencia junto a esa afirmación. Cierra con por qué importa o qué pasa después. Empieza un párrafo nuevo cuando cambia la tarea. Un muro de texto rara vez es un problema de formato; suelen ser cuatro ideas que nunca se separaron.
Claim The new search is not ready for public traffic.
Evidence It times out on 6% of queries above 20,000 records.
Consequence Keep the beta flag on while we add the missing index.
Next claim The fix is small and testable.
Evidence It passed on a production-sized copy this morning.
Consequence Re-run the load test at 4 p.m.; release if errors stay below 0.1%.Los encabezados deberían revelar el argumento. «Recomendación: retrasar dos días» le gana a «Próximos pasos». Alguien que solo escanea los encabezados debería reconstruir la forma del documento sin leer cada línea.
La escritura de oficina convierte los verbos en sustantivos pesados: hacer una evaluación, llevar a cabo una revisión, proporcionar una explicación. Devuelve la acción al verbo. Usa la voz pasiva cuando el actor es desconocido o irrelevante. Recházala cuando esconde responsabilidad. «Se cometieron errores» no es neutral; borra a la persona que puede arreglarlos.
Corporate fog Direct version
We conducted an evaluation of X. We evaluated X.
Implementation will be undertaken. Priya will implement it Monday.
A decision was made to postpone. I postponed the release.
There was a failure in delivery. The courier lost the package.
We are in alignment on the need to… We agree to…Una nota de incidente decía: «La base de datos de producción fue modificada de forma inadvertida». Los líderes pasaron una hora preguntando quién hizo qué. Reescríbela en orden. Nombra al actor: «Nuestro job de migración modificó producción». Nombra la acción exacta: «Eliminó el índice de customer-status». Nombra el efecto y la reparación: «Las consultas se ralentizaron 11 minutos; Ana restauró el índice a las 10:42». La responsabilidad es lo que vuelve útil a la nota.
El asunto es una etiqueta de enrutamiento. Pon ahí la acción y la fecha. En el cuerpo, di la petición en las primeras dos líneas, da solo el contexto necesario para responder y define el formato de la respuesta. «¿Opiniones?» es pereza cuando lo que necesitas es una aprobación.
Subject: Follow-up
Hi all, circling back on the below. Any thoughts would be appreciated.
It would be great if we could get this finalized ASAP.
Subject: Approve homepage copy by Thu 2 p.m.
Mina, please reply “approved” or mark changes in the doc by Thursday
at 2 p.m. We send the page to translation at 3 p.m.
Review only the headline and first paragraph:
https://example.com/doc
If I do not hear back, I will keep the current copy and move translation.Una editora en Londres escribió: «Envía el texto final al final del día». El redactor en San Francisco lo entregó ocho horas después de que ella cerrara el día, y se perdió el espacio de imprenta. Repara la petición con fecha, hora y zona horaria: «Envía el texto final antes de las 5 p.m. BST del 14 de mayo». Después di la consecuencia: «Después de esa hora, el número sale sin este artículo».
La escritura técnica debería permitir que alguien cansado se recupere. Empieza por el resultado y los prerrequisitos. Usa comandos exactos. Muestra el resultado esperado. Incluye el texto real del error, porque eso es lo que la gente busca. Pon la explicación después de la solución, no antes.
Goal
Run the app locally on port 3000. Requires Node 22 and npm 10.
Steps
1. npm ci
2. copy .env.example .env
3. npm run dev
4. Open http://localhost:3000/health
Expected result
HTTP 200
{"status":"ok"}
Real failure
Error: listen EADDRINUSE: address already in use :::3000
Fix
1. Windows: netstat -ano | findstr :3000
2. macOS/Linux: lsof -i :3000
3. Stop the stale process, or run PORT=3001 npm run dev.
4. Open the health URL again on the chosen port.Nunca escribas «simplemente configura el entorno». Nombra el archivo, el ajuste, el valor aceptado y el paso de reinicio. «Debería funcionar» no es un resultado esperado. Da el código de estado, el texto visible o la salida que demuestra el éxito.
Redacta buscando la verdad. Edita pensando en el lector. Intentar perfeccionar cada frase mientras todavía estás descubriendo el argumento hace las dos cosas más lentas. Usa cinco pasadas. Primera: verifica la conclusión. Segunda: muévela arriba. Tercera: corta lo que el lector no necesita. Cuarta: cambia los sustantivos vagos por actores, verbos, fechas y cantidades. Quinta: lee en voz alta y pon a prueba cada petición.
PASS 1 Point: can I state the conclusion in one sentence?
PASS 2 Order: answer → reasons → evidence → action
PASS 3 Cut: throat-clearing, repetition, history nobody needs
PASS 4 Specify: who, does what, by when, measured how
PASS 5 Test: read aloud; open every link; follow every instruction
Search and challenge:
very · really · significant · leverage · facilitate · in order to
it was decided · going forward · at this point in time · thoughts?Cortar no vuelve la prosa fría. Conserva la cortesía, el contexto y el juicio humano. Quita la ceremonia que finge ser cortesía. «¿Podrías echarle un ojo cuando tengas un momento?» es menos amable que una petición clara con un plazo realista.
Usa esto antes de enviar cualquier cosa que le pida a otra persona dedicar tiempo, tomar una decisión o asumir un riesgo.
BEFORE DRAFTING
□ Name one primary reader.
□ Name the action or decision.
□ List the minimum evidence they need.
WHILE EDITING
□ Put the answer in the first sentence.
□ Give each paragraph one claim.
□ Replace vague scale with observed facts.
□ Turn noun phrases back into verbs.
□ Name the actor when responsibility matters.
□ Split sentences with competing jobs.
FOR REQUESTS
□ Action + date in the subject line.
□ Owner, deadline, timezone, response format.
□ State what happens if nobody responds.
FOR INSTRUCTIONS
□ Prerequisites, exact steps, expected result.
□ Real error text and a tested recovery.
FINAL TEST
Could the reader act correctly without asking me what I meant?Mi regla es directa: sonar profesional no es un objetivo de escritura. Un «No, porque la prueba de carga falló» es más profesional que tres párrafos pulidos que esconden la respuesta. Respeta al lector lo suficiente para elegir, ser específico y parar.