Ingeniería de documentación
Ayudo a equipos a crear documentación más fácil de usar, actualizar y mantener.
Consultoría Docs-as-Code, plataformas, referencias generadas y automatización. Trabaja directamente conmigo en la arquitectura, la implementación o la mejora de un sistema existente.
En qué puedo ayudarte
Plataformas y Docs-as-Code
Adapta la estructura del contenido, el proceso de contribución y la plataforma a tus productos. Crea sitios de documentación y portales para desarrolladores con navegación, búsqueda, versiones y revisión en tus repositorios.
Automatización y referencias
Genera referencias de API y CLI a partir de fuentes que tu equipo mantiene. Integra las vistas previas, las comprobaciones de contenido y la publicación en el proceso de lanzamiento para revisar los cambios antes de que lleguen a los usuarios.
Migraciones y mejoras
Revisa el sistema actual, mapea el contenido y las URLs, y planifica la migración. Implementa la conversión, la validación, las redirecciones y las comprobaciones de lanzamiento. Mejora la plataforma existente cuando no sea necesaria una migración completa.
Proyectos seleccionados
ScyllaDB
Herramientas de documentación para más de 20 repositorios, con extensiones de Sphinx y generación automática de referencias de API y CLI.
SNGULAR
Arquitectura de documentación, estrategia de migración, plantillas e incorporación de redactores para más de 45 productos.
Inditex
Codelabs prácticos y repositorios de ejemplo reutilizables para facilitar la adopción de las tecnologías por los desarrolladores internos.
Quién soy
Soy David Garcia, ingeniero de documentación y fundador de TechDocs Studio.
Combino ingeniería de software y arquitectura de documentación. Mi trabajo incluye migraciones a Docs-as-Code, referencias generadas, herramientas de publicación y rutas de aprendizaje para desarrolladores internos. Trabajo directamente con tus equipos de documentación e ingeniería durante todo el proyecto.
Cómo trabajamos
Empezamos por revisar tu plataforma, contenido, colaboradores y proceso de lanzamiento. Juntos elegimos los cambios que harán que el sistema sea más fácil de usar y mantener.
Acordamos el alcance, las responsabilidades, los criterios de aceptación y el precio del proyecto antes de empezar. Tu equipo revisa los cambios en sus propios repositorios y recibe el código, la configuración y las instrucciones para mantener el sistema.
“David escuchó, aportó sugerencias y entregó un proyecto que nos enorgullece mostrar. Su trabajo está bien documentado y facilitó el traspaso al equipo.”
ScyllaDB · Proyecto Docs-as-Code
Tecnologías
- Docusaurus, Zensical y GitBook para proyectos de documentación.
- OpenAPI para generar referencias de API.
- Python y TypeScript para herramientas e integraciones.
- Git y GitHub Actions para los procesos de revisión y publicación.