Docs-as-Ecosystem: The Community Approach to Engineering Documentation
- Length: 268 pages
- Edition: 1
- Language: English
- Publisher: Apress
- Publication Date: 2023-08-09
- ISBN-10: 1484293274
- ISBN-13: 9781484293270
- Sales Rank: #2705543 (See Top 100 Books)
Investing in engineering documentation (Docs) means investing in community user experience. This book teaches how mastering the proposed docs-as-ecosystem model empowers communities to understand better their favorite products and Open-Source (OSS) technologies.
Quetzalli believes that “docs-as-ecosystem” represents a more comprehensive and collaborative approach to documentation development than “docs-as-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 documentation is treated 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.
This Book is For Developers of all levels, VPs of Product/Engineering, Product Managers, and Designers, and OSS community members.
Donate to keep this site alive
How to download source code?
1. Go to: https://github.com/Apress
2. In the Find a repository… box, search the book title: Docs-as-Ecosystem: The Community Approach to Engineering Documentation
, sometime you may not get the results, please search the main title.
3. Click the book title in the search results.
3. Click Code to download.
1. Disable the AdBlock plugin. Otherwise, you may not get any links.
2. Solve the CAPTCHA.
3. Click download link.
4. Lead to download server to download.