Learn Docs-as-Code from the Author Who Helped Define It
Transform how your team writes, manages, and publishes documentation using GitHub, Markdown, and automation. Buy the book to learn how
👉 Stop fighting outdated tools. Start building documentation like software.
We've transformed the way teams work together on docs, and we want to show you the best practices for writing docs using development tools and techniques. Now available in both print and ebook, check out Docs Like Code.
What You’ll Learn
- How to use Git and GitHub for documentation workflows
- Writing and structuring content in Markdown
- Collaborating with developers using pull requests
- Automating publishing with CI/CD
- Scaling documentation across teams and products
Why This Book Matters
Most documentation teams struggle with:
- Siloed tools and workflows
- Slow publishing cycles
- Poor collaboration with engineering
- Content that quickly becomes outdated
Docs Like Code shows you how to fix this.
By applying software development practices to documentation, you can:
- Ship docs faster
- Improve accuracy and consistency
- Collaborate seamlessly with developers
- Build a sustainable, scalable documentation system
Who This Book Is For
This book is for:
- Technical writers working with engineering teams
- Developer advocates and API documentation writers
- Teams adopting docs-as-code workflows
- Anyone using or evaluating GitHub for documentation
This book is not for:
- Complete beginners with no exposure to Git or Markdown
What Experts Say
“A must-read for any technical writer looking to modernize their workflow.”
“Bridges the gap between writers and developers in a practical, actionable way.”
“One of the most useful resources on docs-as-code available today.”
About the Author
Anne is a leader in developer documentation and the author of Docs Like Code.
She has worked extensively on API documentation, developer portals, and docs-as-code workflows across major technology organizations.
Preview the Book
Want to see if it’s right for you?
👉 Read the Quick Start Guide and explore the concepts before you buy.
Docs as Code Quick Start Guide
Buy the Book
Get your copy today:
- Print and ebook editions available
- Ideal for individuals and teams
👉 Start improving your documentation workflow today
Frequently Asked Questions
What is docs as code?
Docs as code is an approach where documentation is written, managed, and published using the same tools and workflows as software development (Git, Markdown, CI/CD).
Why use GitHub for documentation?
GitHub enables version control, collaboration, and automation, making it easier to manage documentation at scale.
What tools are used in docs-as-code?
Common tools include:
- Git and GitHub
- Markdown
- Static site generators (Jekyll, Hugo, Sphinx)
- CI/CD pipelines
Start Building Better Documentation
If you’re ready to modernize your documentation workflow, this book will give you the foundation.
What's inside?
Why use GitHub for docs? If you're unsure of a good fit for your projects and teams, read about the potential wins with these techniques. Or, you may learn how to convince others who need to hear about the use cases.
Information architecture and workflows, how do you choose? Read these chapters to find out lessons learned when making sure the users are served first.
How can I improve upon my team's work? Author and build content like a pro, whether you're a writer or a developer. Build in quality assurance, automate builds, and review with your teammates to make great docs.
What are the best practices for REST API docs? While Swagger/OpenAPI, RAML, and other standards work well when considering the entire API lifecycle, you can also consider collaboration gains with simple markup and narrative documents beyond the REST API reference doc set.
“The wonderful @annegentle introduced me to this a long while ago and Docs Like Code has been a huge improvement in /everything/. Check out https://docslikecode.com”
Cody Bunch
If you haven’t read about it yet I’d recommend you to read — @annegentle #DocsLikeCode #software #product #Documentation #SaaS #tech #techcomm #technology #technicalwriting #techwriter #knowledgebase
Sriram Hariharan
#docsLikeCode refers to the use of repos like #git for source/version control and doc generation. It facilitates #agile docs, in the same sprints as agile dev.
Mike Jang
We do this for all documentation at @GDSTeam. The brilliant @annegentle has written a book on ‘docs as code’ and has case studies and guidance on her website. It works so well!
Jen Lambourne
“Docs as Code” is the search term you’re looking for! #lca2019 #techcomm #docsascode Also, the wonderful @annegentle literally wrote the book on it.
Lana Brindley
Just finished @annegentle’s new book, Docs Like Code — outstanding for devs. If you value quality docs, see the book.
Carol Willing
Just finished “Docs Like Code” by @annegentle — Superb advice for modern technical writing.
Doug Hellmann
This one just moved to the top of my reading list: a book on how to treat docs like code by @annegentle.
Patrick Andriessen