Una página no muestra toda la habilidad
Un artículo pulido demuestra que puedes producir texto pulido. No muestra cómo descubriste información faltante, elegiste audiencia, resolviste requisitos conflictivos o verificaste las instrucciones.
Convierte cada muestra en un pequeño case study.
Explica primero el problema
Indica quién era el lector y qué necesitaba lograr. Describe restricciones: comportamiento incompleto, varias versiones, una fecha de release, terminología regulada o una migración difícil.
Después muestra qué cambiaste y por qué. Un antes/después de la estructura puede ser más informativo que un screenshot final.
Incluye evidencias distintas
Una muestra puede ser un procedimiento, otra API reference y otra arquitectura de información o automatización de calidad. Si no puedes publicar trabajo propietario, recrea el problema con software público o anonimiza sin revelar datos confidenciales.
Muestra cómo verificaste
Cuenta cómo probaste comandos, validaste ejemplos y trabajaste con subject-matter experts. La documentación inspira confianza cuando está conectada con evidencia.
No inventes impacto de negocio.
Facilita la revisión
Tres case studies fuertes suelen ser mejores que veinte enlaces sin contexto. Resume cada uno y permite llegar rápido al artefacto. Comprueba permisos, imágenes y links.
El portfolio debe responder a una pregunta práctica: ¿qué tipo de problema de documentación puede resolver esta persona con nosotros?
Ejemplo aplicado
Convierte «Un portfolio de technical writing debe mostrar decisiones, no solo páginas» en un ejercicio corto con un resultado observable. Elige un artefacto que puedas terminar en una o dos sesiones: un procedimiento de una página, un ejemplo de API, una edición antes/después, una limpieza terminológica o un pequeño caso para el portfolio. Define primero qué significa «mejor».
Conserva evidencia del proceso:
- problema y audiencia originales;
- decisiones tomadas y alternativas descartadas;
- feedback de lector, revisor o experto;
- una cosa que cambiarías en el siguiente intento.
Esto enseña más que acumular cursos de forma pasiva. La escritura técnica es una práctica de decisiones repetidas bajo restricciones; un ejercicio pequeño y terminado con revisión real aporta más que un proyecto teórico que nunca llega a un lector.
Lista rápida de revisión editorial
- Una página no muestra toda la habilidad. Un artículo pulido demuestra que puedes producir texto pulido.
- Explica primero el problema. Indica quién era el lector y qué necesitaba lograr.
- Incluye evidencias distintas. Una muestra puede ser un procedimiento, otra API reference y otra arquitectura de información o automatización de calidad.
- Muestra cómo verificaste. Cuenta cómo probaste comandos, validaste ejemplos y trabajaste con subject-matter experts.
