Descripción
Invertir en documentación de ingeniería (Docs) significa invertir en la experiencia de usuario de la comunidad. Este libro enseña a los lectores cómo dominar el ecosistema "docs-as-code" capacita a las comunidades para comprender mejor sus productos favoritos y las tecnologías de código abierto (OSS).
La autora Alejandra Quetzalli cree que "docs-as-ecosystem" representa un enfoque más completo y colaborativo para el desarrollo de documentación que "docs-as-code" porque reconoce que la documentación es más que solo código. Los documentos involucran redacción técnica, diseño, retroalimentación de la comunidad, gestión de la comunidad, accesibilidad, SEO, UX y, hoy en día... ¡incluso herramientas de Inteligencia Artificial! La palabra ecosistema promueve un paradigma donde tratamos la documentación como un sistema complejo y dinámico que debe ser gestionado y nutrido.
En este libro, adquirirás habilidades prácticas como la creación de guías de estilo públicas, la incorporación de un diseño responsivo y accesible, el diseño de flujos de usuario y arquitectura de información, la recuperación de comentarios de los usuarios y la configuración de análisis de Docs. Aprenderás a identificar la diferencia en los procesos de trabajo entre mantener Docs para un producto y una tecnología OSS. Descubrirás los secretos para gestionar redactores técnicos y contribuciones de OSS, todo mientras construyes una comunidad de Docs próspera. Para terminar con una nota futurista, descubrirás por qué los redactores técnicos que aprovechan las herramientas de Inteligencia Artificial (IA) (es decir, ChatGPT) no tienen por qué temer una rebelión de robots en el corto plazo.
Lo que aprenderás
- Examinar la accesibilidad y la experiencia del usuario
- Comprender la arquitectura de la información
- Revisar los procesos de docs-as-ecosystem
- Gestionar redactores técnicos
- Supervisar las contribuciones de Docs de OSS
- Recuperar e integrar los comentarios de los usuarios
- Construir comunidades de Docs y Educación
Desarrolladores de todos los niveles, vicepresidentes de producto/ingeniería, gerentes de producto y diseñadores,
Autor: Alejandra Quetzalli
Editorial: Apress
Publicado: 09/08/2023
Páginas: 242
Tipo de encuadernación: Tapa blanda
Peso: 1.04lbs
Tamaño: 10.00h x 7.00w x 0.57d
ISBN13: 9781484293270
ISBN10: 1484293274
Categorías BISAC:
- Informática | Internet | Programación web
- Informática | Programación | Código abierto
- Informática | Desarrollo e ingeniería de software | General
Sobre la autora
Alejandra Quetzalli es una latina de México con 10 años de experiencia en la industria tecnológica y un perro de servicio de autismo dedicado, Canela. Canela trabaja codo a codo con Alejandra, incluso acompañándola en sus viajes y charlas en conferencias tecnológicas por todo el mundo. A lo largo de su carrera, Alejandra ha trabajado en SEO, Paid Search, desarrollo Full-Stack, UX, relaciones con desarrolladores, redacción técnica (documentación de ingeniería), AWS Cloud Advocacy, startups y código abierto (OSS). Actualmente es mantenedora principal en AsyncAPI Initiative, liderando iniciativas de OSS para AsyncAPI Docs y Educación. En 2022, se convirtió en miembro del Comité Directivo Técnico (TSC) de AsyncAPI.
En 2016, fundó sheCodesNow.org para ofrecer talleres de programación accesibles para mujeres y minorías que buscan ingresar al sector tecnológico. Hoy, sheCodesNow ha crecido hasta desarrollar cursos técnicos en redacción técnica, relaciones con desarrolladores y construcción de comunidades tecnológicas.