Skip to Content
Crafting Docs for Success: An End-to-End Approach to Developer Documentation
book

Crafting Docs for Success: An End-to-End Approach to Developer Documentation

by Diana Lakatos
September 2023
Intermediate to advanced
219 pages
4h 39m
English
Apress

Overview

Developer documentation is a powerful tool in developer relations because it provides all the necessary information during the onboarding process and keeps your users informed on changes such as release notes, status reports and new and updated topics. Using a design thinking approach, this book aims to provide an easy to follow blueprint for building successful developer documentation by using the award winning platformOS developer portal as inspiration.

You'll work with practical usable templates, workflows, and tools validated and peer-reviewed by international experts in the fields of documentation, technical writing, developer relations, and UX design. This book reveals the many factors that must be considered while crafting developer documentation, such as hitting the right target audience, designing a seamless onboarding experience, and selecting the right workflows and data analysis methods. You'll delve into this complex mix of topics, each with its unique considerations, and understand why it’s difficult for those working on developer documentation to understand the process, as well as all the necessary ingredients, tools, and resources to overcome that challenge. 

Crafting Docs for Success is your one-stop resource for empowering your team and community to contribute and help maintain your documentation, as well as further improve diversity and inclusion. 

What You'll Learn

  • Examine how user research facilitates documentation development

  • Utilize design thinking, community-driven documentation, and Docs as Code 

  • Understand editorial workflows and what happens at each step

  • Write a style guide from scratch and use it for content production

  • Review how methods and strategies fall into place during technical implementation

Who This Book Is For

Software developersand designers, documentation maintainers and managers, technical writers, developer relations practitioners and advocates, technical community managers, developer marketers, and start-up founders, CTOs, and CEOs


Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

AirBnbBlueOriginElectronic ArtsHomeDepotNasdaqRakutenTata Consultancy Services

QuotationMarkO’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.
Julian F.
Head of Cybersecurity
QuotationMarkI wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.
Addison B.
Field Engineer
QuotationMarkI’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.
Amir M.
Data Platform Tech Lead
QuotationMarkI'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.
Mark W.
Embedded Software Engineer

You might also like

Docs for Developers: An Engineer’s Field Guide to Technical Writing

Docs for Developers: An Engineer’s Field Guide to Technical Writing

Jared Bhatti, Sarah Corleissen, Jen Lambourne, David Nunez, Heidi Waterhouse
Patterns for API Design: Simplifying Integration with Loosely Coupled Message Exchanges

Patterns for API Design: Simplifying Integration with Loosely Coupled Message Exchanges

Olaf Zimmermann, Mirko Stocker, Daniel Lubke, Uwe Zdun, Cesare Pautasso

Publisher Resources

ISBN: 9781484295946Purchase LinkPublisher Website