Diseño el sistema, no solo la página
- Automatización de documentación de API activada por releases
- Skill de creación que convierte borradores en MDX
- Implementaciones completas de portales mediante un ciclo con Claude y el conector de ReadMe
Acerca de Christian Arango
De la traducción a la comunicación de producto
Soy Christian Arango, escritor técnico, diseñador de contenido e ingeniero de documentación con más de siete años de experiencia. Me formé como traductor, y el paso a la redacción técnica fue natural: en ambos oficios se reconstruye un mensaje para que un lector concreto lo entienda y pueda actuar.
La comunicación de producto lleva el sentido entre personas y formatos: de la explicación de un ingeniero al siguiente paso de un usuario, del código a una prosa clara. Trabajo en toda esa cadena, con flujos asistidos por IA y criterio propio.
Open to work: contratista o empleado
Cargos en ingeniería de documentación, redacción técnica y diseño de contenido, en Medellín o remotos para EE. UU., LATAM y la UE
El marketing hace la promesa. La interfaz la vuelve usable. La documentación la explica. La terminología la mantiene coherente. La localización la hace funcionar en otra cultura.
Lo que hago
Redacción, diseño, herramientas y publicación
Diseño de contenido y UX writing
Textos de interfaz, flujos de incorporación y procedimientos que funcionan como un solo sistema de lenguaje.
Documentación de API y de producto
Referencias REST, webhooks y guías de integración, auditadas frente a comentarios reales de soporte.
Plataformas de documentación y web
Interfaces personalizadas en ReadMe, Mintlify y GitBook, componentes MDX reutilizables y sitios como este.
Automatización y herramientas con IA
Documentación de API activada por releases, revisión en Git con decisiones de publicación, y skills y agentes de Claude.
Mira las ocho capacidades en detalle
Diseño de contenido y UX writing
Escribo textos de interfaz, etiquetas, estados, mensajes de error y flujos de incorporación, y leo una interfaz como un sistema de lenguaje: jerarquía, términos y la siguiente acción que pide.
Diseño web y desarrollo front-end
Diseño y construyo sitios donde contenido e interfaz parten de una misma intención, con diseño adaptable, componentes accesibles, tokens de diseño y rutas localizadas. Este sitio es uno de ellos.
Automatización del pipeline de documentación
Creé, junto con un release engineer, una automatización que actualiza la documentación de API a partir de cada release. También diseño flujos de revisión y publicación basados en Git, con decisiones explícitas de publicar o no publicar.
Herramientas de documentación asistidas por IA
Creé un skill de creación para Claude Code que convierte borradores en MDX para revisión, además de agentes que usan conectores de Model Context Protocol (MCP) para responder preguntas sobre la documentación.
Ingeniería de plataformas de documentación
Personalizo interfaces de documentación con HTML, CSS y JavaScript, creo componentes MDX reutilizables y trabajo con ReadMe, Mintlify y GitBook. Mi experiencia incluye un API playground desarrollado con ReadMe.
Documentación de API
Escribo referencias de API REST, documentación de webhooks y guías de integración. Audito endpoints, versiones y campos frente a comentarios de soporte con Postman, Swagger/OpenAPI y Redoc.
Docs-as-code
Uso Git, Bitbucket, Markdown/MDX y pipelines de integración y entrega continuas (CI/CD) para darle a la documentación el mismo rigor de revisión y publicación que al código.
Adopción y habilitación
Escribo procedimientos operativos estándar y capacito equipos para operar flujos de documentación. En Lean Tech dirigí y acompañé a cuatro escritores técnicos.
Enfoque
Cómo convierto un problema de documentación en un sistema
Mido la documentación por lo que cambia
- 45 % menos tickets de soporte en Recurly
- Satisfacción del 56 % al 92 % en ReadMe Enterprise
- 30 % menos consultas sobre documentación tras renovar la documentación de API en Lean Tech
Hago que la automatización se sostenga en la organización
- Presentación ante todo el departamento de tecnología
- Procedimientos que cualquier equipo puede seguir
- Technology Impact Award del CTO de Recurly, 2025
Trayectoria
De la redacción técnica a la ingeniería de documentación
Me formé como traductor; desde 2018 soy escritor técnico y consultor, fui Technical Writing Manager en Lean Tech (2022–2024) y escritor técnico sénior en Recurly (2023–2026).
Mira la trayectoria completa
- Mayo de 2023 — oct. de 2026Medellín · Remoto e híbrido
Senior L&D & IT Technical Writer · Recurly
- Me encargué de principio a fin de la documentación de Subscriptions API, Webhooks y Recurly.js, incluida la gobernanza de publicación entre ReadMe, bases de datos internas y Jira.
- Lideré la evaluación, negociación e implementación de ReadMe Enterprise y consolidé la documentación de tres productos en un solo portal.
- Creé la automatización activada por releases, el skill de creación para Claude Code y agentes con conectores MCP que reemplazaron un proceso manual de respuesta de dos a cuatro horas.
- 2022 — 2024Medellín
Technical Writing Manager · Lean Tech
- Dirigí y acompañé a cuatro escritores técnicos; introduje flujos basados en Git, procesos de revisión y estándares de estilo para varios productos SaaS.
- Reduje cerca de un 80 % el tiempo que el equipo tardaba en completar tareas mediante flujos asistidos por LLM, plantillas y estándares de consistencia.
- Lideré la renovación de una documentación de API que llevaba cuatro años desactualizada y restablecí su precisión técnica.
- Mayo — jul. de 2022Medellín
Senior Technical Writer · Lean Tech
- Redacté manuales de integración, guías de usuario y documentación de plataforma con plazos ajustados, además de una guía de contenidos de 24 páginas que se convirtió en la base para mantener la coherencia documental.
- 2018 — actualidadRemoto
Escritor técnico y consultor de contenidos · Freelance
- Sistemas de documentación de principio a fin para startups y clientes SaaS: documentación de API, guías de incorporación, bases de conocimiento, plantillas y procesos editoriales que les permiten crecer.
Mira las herramientas que uso, por propósito
IA y agentes
- ClaudeInvestigación, redacción y revisión estructurada
- Claude CodeProgramación con agentes y skills de redacción reutilizables
- ChatGPTInvestigación, comparaciones y verificación terminológica
- CodexProgramación con agentes dentro del repositorio
- OpenCodeAgente de programación de código abierto en la terminal
- MCPConectores que dan a los agentes acceso a documentos y herramientas
Plataformas de documentación
- ReadMePortales para desarrolladores, referencias de API y CSS y JavaScript a medida
- MintlifyDocumentación para desarrolladores basada en MDX
- GitBookBases de conocimiento y documentación de producto
- DocusaurusSitios docs-as-code basados en React
- JekyllSitios de documentación estáticos a partir de Markdown
Web y frameworks
- AstroSitios estáticos, multilingües y basados en componentes, como este
- Next.jsFramework de React para aplicaciones web y documentación
- Node.jsScripts de compilación, herramientas y pruebas
- HTMLEstructura semántica y accesibilidad
- CSSTokens de diseño, maquetación y temas
- JavaScriptComponentes interactivos y extensiones de interfaz
Docs-as-code y seguimiento
- GitControl de versiones para documentación y código
- GitHubRepositorios, pull requests y revisiones
- BitbucketRepositorios y flujos de revisión
- MarkdownRedacción en texto plano
- MDXMarkdown con componentes reutilizables
- CI/CDVerificaciones, compilaciones y publicaciones automáticas de documentación
- JiraSeguimiento de versiones y gobernanza de publicación
API
- PostmanPrueba de endpoints antes de documentarlos
- Swagger · OpenAPI · RedocEspecificaciones de API y las referencias que se generan a partir de ellas
Despliegue y dominios
- VercelDespliegues y vistas previas con cada push
- GoDaddyDominios y DNS
Mira formación, idiomas y certificaciones
- Educación
- Pregrado en Traducción (inglés–francés–español), Universidad de Antioquia, 2017–2022. Gestión terminológica y comunicación intercultural y técnica.
- Idiomas
- Español (nativo) · Inglés (C1–C2) · Francés (B2)
- Certificaciones
- AI Fluency Framework & Foundations · Introduction to Claude Cowork · Claude 101 · Technical Writing: How to Write Software Documentation (LinkedIn Learning)
- Reconocimientos
- Technology Impact Award, Recurly, otorgado por el CTO (2025)
Documentación desactualizada
Enlace roto
Guía pendiente