I've been a technical writer or technical editor for decades. But not until 2020 did I serve on an Agile development team. I should have read this book in 2020! I thought I was doing all I could to help my readers and my team. I wasn't ... but soon I will.
I read eight to twelve books on writing each year. But most deal with the art of crafting sentences a paragraphs. Thanks to this book, I plan to read more books devoted to the tech writing as a process.
Let me add that the Splunk book ranks as one of the best-written, best-edited writing books I've had the pleasure to read. Try as I might, I couldn't find more than five or six nits to pick. Most were about concordance of grammatical person. The Introduction begins, "In the course of doing our work, the Splunk documentation team strives to adopt—and adapt—industry best practices whenever we can find them." "Our work" promises that the main subject will be the first person "we." Nope: It's the third person "the ... team." Then it's back to "we" in "whenever we can find them." But again, I see this practice everywhere. In 10 years, no one will understand why people like me ever cared.
Buy new:
$12.99$12.99
Ships from: Amazon.com Sold by: Amazon.com
Buy new:
$12.99$12.99
Ships from: Amazon.com
Sold by: Amazon.com
Save with Used - Acceptable
$7.05$7.05
Ships from: Goodwill of North Georgia Sold by: Goodwill of North Georgia
Save with Used - Acceptable
$7.05$7.05
Ships from: Goodwill of North Georgia
Sold by: Goodwill of North Georgia
$7.05 $7.05
Only 1 left in stock - order soon.
$$12.9912.99
()
Includes selected options. Includes initial monthly payment and selected options.
Details
Price ($12.99x)
$12.99
Subtotal
$$12.9912.99
Subtotal
Initial payment breakdown
Shipping cost, delivery date, and order total (including tax) shown at checkout.
Access codes and supplements are not guaranteed with used items.
Add to Cart
Enhancements you chose aren't available for this seller. Details
To add the following enhancements to your purchase, choose a different seller.
%cardName%
${cardName} not available for the seller you chose
${cardName} unavailable for quantities greater than ${maxQuantity}.
Unable to add item to List. Please try again.
Sorry, there was a problem.
There was an error retrieving your Wish Lists. Please try again.Sorry, there was a problem.
List unavailable.
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.
The Product is Docs: Writing technical documentation in a product development group Paperback – March 5, 2020
by
Christopher Gales
(Author),
Splunk Documentation Team
(Author)
Sorry, there was a problem loading this page. Try again.
{"desktop_buybox_group_1":[{"displayPrice":"$12.99","priceAmount":12.99,"currencySymbol":"$","integerValue":"12","decimalSeparator":".","fractionalValue":"99","symbolPosition":"left","hasSpace":false,"showFractionalPartIfEmpty":true,"offerListingId":"ua5D66tCWUexKS%2BmUcvt%2FmjB%2Fp3g%2FhArnY%2BsjBzRqwfUCV0hAZ%2Fo1%2FR%2FJWvbbtjncnLwGSLr%2BcT0jyMX2qyHejSXEDUM%2FDgQIFpXhtihKijlfbEzMWMGrgZFW0IICS9GuM5YO7XrmJPLzd%2BpRAGF6Q%3D%3D","locale":"en-US","buyingOptionType":"NEW","aapiBuyingOptionIndex":0}, {"displayPrice":"$7.05","priceAmount":7.05,"currencySymbol":"$","integerValue":"7","decimalSeparator":".","fractionalValue":"05","symbolPosition":"left","hasSpace":false,"showFractionalPartIfEmpty":true,"offerListingId":"ua5D66tCWUexKS%2BmUcvt%2FmjB%2Fp3g%2FhArbR1ewoYxRvl9UVNDFGIQvNFk1wHi%2F9YinOQshFVY9daOEWs0atp1oRgWU4ZVXvjgPEZzdhAJqcF63UuIZUcERrFoF9x9cWGc8L0fhBzyUtosqsl8aj1d0X%2FeCo6LXOmacf4qM6VLkEDEwwc%2BQWA1VeO%2BhXfXQLc8","locale":"en-US","buyingOptionType":"USED","aapiBuyingOptionIndex":1}]}
Purchase options and add-ons
Revised and expanded in 2020!
This book provides a broad perspective about the essential aspects of creating technical documentation in today's product development world. It is a book of opinions and guidance, collected as short essays. You can read selectively about subjects that interest you, or you can read the entire collection in any order you like. Information development is a multidimensional discipline, and it is easy to theorize. We have written this book from our direct experience, using the concrete insights and practices we apply to our work every day.If you work as an information developer, a manager in a documentation team, or in another part of product development that collaborates with a doc team, there is information in this book for you. Perhaps you are a technical writer in a small, high-growth company that is figuring out its processes. Perhaps you are an information-development manager in a large enterprise company with an expanding product line and an ever more complex matrix of cross-functional dependencies. You might work at a medium-sized company where your management is asking you to do more with fewer people, and you want some additional perspective that will help you find a leaner and more effective way to deliver what your business demands. Or you might work outside the technical documentation world, in another part of product development, and are wondering how to collaborate most effectively with the documentation team.The purpose of The Product is Docs is to provoke discussion, shine light on some murky areas, and—we hope—inspire our colleagues to consider their processes and assumptions with new eyes.All proceeds from the sale of The Product is Docs will go to charity.
This book provides a broad perspective about the essential aspects of creating technical documentation in today's product development world. It is a book of opinions and guidance, collected as short essays. You can read selectively about subjects that interest you, or you can read the entire collection in any order you like. Information development is a multidimensional discipline, and it is easy to theorize. We have written this book from our direct experience, using the concrete insights and practices we apply to our work every day.If you work as an information developer, a manager in a documentation team, or in another part of product development that collaborates with a doc team, there is information in this book for you. Perhaps you are a technical writer in a small, high-growth company that is figuring out its processes. Perhaps you are an information-development manager in a large enterprise company with an expanding product line and an ever more complex matrix of cross-functional dependencies. You might work at a medium-sized company where your management is asking you to do more with fewer people, and you want some additional perspective that will help you find a leaner and more effective way to deliver what your business demands. Or you might work outside the technical documentation world, in another part of product development, and are wondering how to collaborate most effectively with the documentation team.The purpose of The Product is Docs is to provoke discussion, shine light on some murky areas, and—we hope—inspire our colleagues to consider their processes and assumptions with new eyes.All proceeds from the sale of The Product is Docs will go to charity.
- Print length291 pages
- LanguageEnglish
- Publication dateMarch 5, 2020
- Dimensions5.5 x 0.66 x 8.5 inches
- ISBN-13979-8621549824
Frequently bought together

This item: The Product is Docs: Writing technical documentation in a product development group
$12.99$12.99
Get it as soon as Sunday, May 18
In Stock
$39.11$39.11
Get it as soon as Sunday, May 18
In Stock
$15.00$15.00
Get it as soon as Sunday, May 18
In Stock
Total price: $00$00
To see our price, add these items to your cart.
Try again!
Added to Cart
Add all 3 to Cart
Choose items to buy together.
Customers who viewed this item also viewed
Page 1 of 1 Start overPage 1 of 1
Docs for Developers: An Engineer’s Field Guide to Technical WritingPaperbackFREE Shipping by AmazonGet it as soon as Sunday, May 18
Docs Like Code: Collaborate and Automate to Improve Technical DocumentationPaperbackFREE Shipping on orders over $35 shipped by AmazonGet it as soon as Sunday, May 18
Developing Quality Technical Information: A Handbook for Writers and Editors (IBM Press)PaperbackFREE Shipping by AmazonGet it as soon as Sunday, May 18Only 8 left in stock - order soon.
The Insider's Guide to Technical WritingPaperbackFREE Shipping by AmazonGet it as soon as Sunday, May 18Only 7 left in stock - order soon.
Technical Writing Process: The simple, five-step guide that anyone can use to create technical documents such as user guides, manuals, and proceduresPaperbackFREE Shipping on orders over $35 shipped by AmazonGet it as soon as Sunday, May 18
Technical & Business Writing (Quickstudy Reference Guides - Academic)PamphletFREE Shipping on orders over $35 shipped by AmazonGet it as soon as Sunday, May 18
Product details
- ASIN : B085KK6G8F
- Publisher : Independently published (March 5, 2020)
- Language : English
- Paperback : 291 pages
- ISBN-13 : 979-8621549824
- Item Weight : 13.4 ounces
- Dimensions : 5.5 x 0.66 x 8.5 inches
- Best Sellers Rank: #571,510 in Books (See Top 100 in Books)
- #36 in Technical Writing Reference (Books)
- #3,576 in Engineering (Books)
- #5,477 in Computers & Technology (Books)
- Customer Reviews:
Related products with free delivery on eligible orders
Page 1 of 1Start overPage 1 of 1
Sponsored | Try Prime for unlimited fast, free shipping
Customer reviews
4.6 out of 5 stars
4.6 out of 5
99 global ratings
How customer reviews and ratings work
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 November 22, 2023
- Reviewed in the United States on July 21, 2022I just finished this book. It's excellent. I work in the technical documentation field. It struck me as more practical and real-world based than the way technical documentation is often presented elsewhere. When you're in the weeds, the day-to-day of software creation and its documentation, rigid processes tend to break, complex processes tend to break down, and sometimes what seemed like simplification of the overall process turns out to slow it down or reduce quality.
- Reviewed in the United States on March 12, 2018This book described many ways to in which strengthening the relationships between the docs and other functional teams is instrumental in delivering a high quality product, maintaining customer trust and staying competitive in a modern world. The author and his team present down to earth strategies for establishing constructive and collaborative relationships in often tight timeline environments.
Help executives notice the positive impact the docs team has on the bottom line because of the collaborative foundational guidelines and processes this book helps you build and maintained. Encourage engineers to be heavily involved and responsive to the documentation process by using tips and tricks in this book to adapt to their workflows and minimize their disruption. The book offers advice on developing cross-team initiatives and workflows to help keep you in the loop with the marketing team and their initiatives.
- Reviewed in the United States on March 27, 2018This is an excellent overview and guide to technical writing as currently practiced. This is useful for people new to (or considering) a career in technical writing, for experienced writers who want to update their skills, and for managers looking for guidance. The topics are relevant to anyone who wants to learn more about technical writing in a modern software company, including how to work in an Agile environment, the need for extensive collaboration, how and why to create task-based documentation, and how to measure the results of your work. Even better, this book is concise, and each section gets to the point quickly and without filler.
- Reviewed in the United States on December 18, 2019This book has given me a lot of good advice to consider as I've been considering my own role as a technical writer for a software company and how I'll collaborate with other teams to do my best work!
- Reviewed in the United States on February 13, 2020From the team at Splunk, this book gives us not just a window into the ins-and-outs of technical writing. It gives helpful advice along each step (organized in short, punctual chapters) to navigate and do well. The focus is on producing good documentation within a team, whether it's a team of software developers or corporate management.
Some chapters have greater detail than others. (Hey, nobody's perfect.) If that's the only caveat though, you've got a winner on your hands. I would gladly recommend this book to people interested in tech writing, novice writers, and even writers in other fields looking to switch to documentation.
- Reviewed in the United States on December 19, 2024It was recommended reading for technical writing but nothing I couldn’t learn on my own.
Top reviews from other countries
shalzReviewed in India on December 31, 20213.0 out of 5 stars Nice read. Formatting could have been better.
This is really a good book. I read it on Kindle. May be that is why I have the formatting comment. Besides that, I'd also love to see summary of key points in each chapter - say at the end. Technical writing templates would add to usefulness of this book. For example in Technical Editing chapter, I'd have loved to see some examples or links to GitHub projects that have 'awesome' technical writing - that would be really useful for new, first time, non-experienced writers (read SW developers).
"Karina Lehrner-Mayer"Reviewed in Germany on June 20, 20185.0 out of 5 stars Best book on technical writing
As a technical writer of more than 15 years, I found this book inspiring, packed with real-life examples and advice, and lots of “yes, have been there, too” moments. A good read. And probably the best book on technical writing that you can currently find on the market. Kudos to the team of authors.



![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)


