Quetzalli A. Docs-as-Ecosystem...Approach to Engineering Documentation 2023 torrent

Textbook in PDF format

Investing in engineering documentation (Docs) means investing in community user experience. This book teaches readers how mastering the docs-as-code ecosystem empowers communities to understand better their favorite products and Open-Source (OSS) technologies better.
Author Alejandra Quetzalli believes that “docs-as-ecosystem” represents a more comprehensive and collaborative approach to documentation development than “docsas- code” because it recognizes that documentation is more than just code. Docs involve technical writing, design, community feedback, community management, accessibility, SEO, UX, and today… even Artificial Intelligence tools! The word ecosystem promotes a paradigm where we treat documentation as a complex and dynamic system that must be managed and nurtured.
In this book, you’ll acquire practical skills such as creating public style guides, incorporating responsive and accessible design, designing user flows and information architecture, retrieving user feedback, and setting up Docs analytics. You’ll learn to identify the difference in work processes between maintaining Docs for a product versus an OSS technology. You’ll discover the secrets to managing technical writers and OSS contributions, all while building a thriving Docs community. To end on a futuristic note, you’ll discover why technical writers who harness Artificial Intelligence (AI) tools (i.e., ChatGPT) need not fear a robot uprising anytime soon. In this chapter, I will introduce Artificial Intelligence (AI) roles and AI tools such as ChatGPT in technical writing. We will examine how technical writers can harness ChatGPT (an AI language model created by OpenAI) as a research tool in technical writing.
What You'll Learn
Examine accessibility and the user experience
Understand Information architecture
Review docs-as-ecosystem processes
Manage technical writers
Oversee OSS Docs contributions
Retrieve and integrate user feedback
Build Docs and Education communities
Preface: Why Docs-as-Ecosystem?
Accessibility
Information Architecture
Search Engine Optimization
User Interface and User Experience
Documenting APIs
Documenting SDKs
Integrating Docs into CI/CD Pipelines
Crafting Public Style Guides
Managing OSS Docs Contributions
Retrieve Community Feedback and Analytics
Prioritize Documentation Requests
Open Community Communication Channels
Managing Technical Writers
The Future of ChatGPT and AI in Docs