Download the free Kindle app and start reading Kindle books instantly on your smartphone, tablet, or computer - no Kindle device required.
Read instantly on your browser with Kindle for Web.
Using your mobile phone camera - scan the code below and download the Kindle app.
Docs Like Code Paperback – September 9, 2017
- Print length116 pages
- LanguageEnglish
- Publication dateSeptember 9, 2017
- Dimensions7.44 x 0.27 x 9.69 inches
- ISBN-101387081322
- ISBN-13978-1387081325
Book recommendations, author interviews, editors' picks, and more. Read it now
Customers who bought this item also bought
The Product is Docs: Writing technical documentation in a product development groupChristopher GalesPaperbackFREE Shipping on orders over $35 shipped by AmazonGet it as soon as Sunday, May 18
Product details
- Publisher : Lulu.com; Second Edition (September 9, 2017)
- Language : English
- Paperback : 116 pages
- ISBN-10 : 1387081322
- ISBN-13 : 978-1387081325
- Item Weight : 8.8 ounces
- Dimensions : 7.44 x 0.27 x 9.69 inches
- Best Sellers Rank: #1,939,580 in Books (See Top 100 in Books)
- #42,609 in Computers & Technology (Books)
- Customer Reviews:
About the author

Anne Gentle is a developer experience leader, helping companies define and grow their strategic developer relations programs. Previously a Director at Cisco, her team worked on API quality assessments and API documentation with OpenAPI specifications, interactive REST API documentation, and developer tutorials. She pursues eliminating biased language in code and content with open source projects. Anne wrote the book, Docs Like Code, to provide practical guidance for docs-as-code workflows with GitHub, automation, and enhanced processes for developers and writers to work together. She proudly serves on the Austin Community College Workforce Advisory Committee, pushing the field toward future opportunities in API and developer documentation.
Products related to this item
Customer reviews
Customer Reviews, including Product Star Ratings help customers to learn more about the product and decide whether it is the right product for them.
To calculate the overall star rating and percentage breakdown by star, we don’t use a simple average. Instead, our system considers things like how recent a review is and if the reviewer bought the item on Amazon. It also analyzed reviews to verify trustworthiness.
Learn more how customers reviews work on AmazonTop reviews from the United States
There was a problem filtering reviews. Please reload the page.
- Reviewed in the United States on March 24, 2022Gentle’s book is a great companion to Tom Johnson’s API Documentation course on idratherbewriting.com. Gentle’s book provides talking points you can use to get leadership excited about and gain their approval for transforming the traditional documentation approach to docs-like-code. Then she digs into the detail a technical writer needs to understand how this whole docs-like-code thing works. She uses the book itself to exemplify this, since this was the approach she took to create and publish it. At the end she offers a tutorial to see for yourself how quickly this can be implemented. I’m in the midst of the tutorial so we’ll see!
- Reviewed in the United States on January 17, 2022The content gravitates to GitHub, development and bash.
It is very weak on explaining what git is and how it works. Examples are a bit too complex and you really don’t need to enter all the parameters used in some of them.
Some important git practices are omitted and some is unsuitable.
I.e GitFlow is really begging for issues, don’t even contemplate that branch strategy.
Git messages are essential for reading the flow of change and should *always* contain at last the What and the Why.
The world actually don’t consist of only bash and vi. PowerShell with posh-git and Visual Code (with gitlens, githraph, markdownlint and other plug-ins) are at least as good a combination as bash/vi.
But if you are used to it, don’t change it.
Although the book uses developement and API:s as a story background, the usage can be applied to configuration system such as Ansible and PowerShell Desired State Configuration as well.
- Reviewed in the United States on June 7, 2022Great read especially if you are just getting started in technical writing. Not a long book, I finished in 2 days. Would’ve finished on the 1st day but the book was delivered later in the day. I would recommend this book for beginner to intermediate level tech writers. But I’m sure more advance tech writers might even find some things useful from the book.
- Reviewed in the United States on September 20, 2022Many organizations and teams think of documentation as an afterthought. In Docs Like Code, Anne Gentle describes a better way and approach to documentation. I highly recommend this book to anyone who needs to document your project (HINT: that's everyone) and struggles to find a good approach.
- Reviewed in the United States on August 20, 2017I thought this was a terrific introduction for technical communicators interested in migrating both their content source and philosophic paradigms to a code-based model. I think the book was broad enough to allow for multiple use cases and also specific enough for actual, pragmatic help in the here and now.
Even though I've used this model for years, I learned a few things in Docs Like Code that I'm going to take to my team and propose that we put in practice. It's an awesome resource for any writer interested in honing their craft.
- Reviewed in the United States on December 23, 2021bad book
I wanted to learn how to write good documentation inside code but it only explains how to publish existing docs as website
- Reviewed in the United States on December 25, 2018This book was useful in figuring out what kind of starting point someone who has been writing technical docs in the pre-github era comes from. I didn't learn much new. Is well written though!
Top reviews from other countries
-
David CReviewed in France on November 5, 20225.0 out of 5 stars Bonne aide de depart
Ce livre est bien ecrit et vous donne les bases de la philosophies doc as code, grace a ce lire vous aurez les pistes a suivre et les differents outils que vous pourrez utiliser pour votre documentation et cela pour un travail collaboratif ou individuel
Pour l’expertise, il faudra chercher par vous même plus d’informations sur le language, et sur les outils, mais ce livre vous aide a commencer
Govind ChandranReviewed in India on January 26, 20211.0 out of 5 stars Buyer Beware: Fake Copy
I was disappointed on seeing the book. I paid 1800 INR for the book, which seems like a rip off for a book that was printed by a regular printing press! The paper quality is bad, and the printing is not even. This book is an original copy, intact it is definitely printed by a local press.
I was disappointed on seeing the book. I paid 1800 INR for the book, which seems like a rip off for a book that was printed by a regular printing press! The paper quality is bad, and the printing is not even. This book is an original copy, intact it is definitely printed by a local press.1.0 out of 5 stars
Govind ChandranBuyer Beware: Fake Copy
Reviewed in India on January 26, 2021
Images in this review
somenameReviewed in the United Kingdom on March 8, 20181.0 out of 5 stars Rather basic but is good for an overview
Rather basic but is good for an overview. However, some text(?) inserts don't render in the Kindle reader properly, all I can see is gibberish in what I suppose is an example, sometimes with text.
-
JAMES GéraldineReviewed in France on February 23, 20221.0 out of 5 stars Article endommagé
Je suis mécontente. Le livre commandé est arrivé en mauvais état, comme en témoignent les photos jointes (tranche de la couverture endommagée et ouvrage plié/déformé).
Je suis mécontente. Le livre commandé est arrivé en mauvais état, comme en témoignent les photos jointes (tranche de la couverture endommagée et ouvrage plié/déformé).1.0 out of 5 stars
JAMES GéraldineArticle endommagé
Reviewed in France on February 23, 2022
Images in this review


![The Google Workspace Bible: [14 in 1] The Ultimate All-in-One Guide from Beginner to Advanced | Including Gmail, Drive, Docs, Sheets, and Every Other App from the Suite](https://m.media-amazon.com/images/I/41Y9hG4k9OL._AC_SR100,100_QL65_.jpg)





