Docs for Developers: An Engineer’s Field Guide to Technical Writing
£32.40£38.00 (-15%)
Learn to integrate programming with good documentation. This book teaches you the craft of documentation for each step in the software development lifecycle, from understanding your users’ needs to publishing, measuring, and maintaining useful developer documentation.
Well-documented projects save time for both developers on the project and users of the software. Projects without adequate documentation suffer from poor developer productivity, project scalability, user adoption, and accessibility. In short: bad documentation kills projects.
Docs for Developers demystifies the process of creating great developer documentation, following a team of software developers as they work to launch a new product. At each step along the way, you learn through examples, templates, and principles how to create, measure, and maintain documentation―tools you can adapt to the needs of your own organization.
What You’ll Learn
- Create friction logs and perform user research to understand your users’ frustrations
- Research, draft, and write different kinds of documentation, including READMEs, API documentation, tutorials, conceptual content, and release notes
- Publish and maintain documentation alongside regular code releases
- Measure the success of the content you create through analytics and user feedback
- Organize larger sets of documentation to help users find the right information at the right time
Who This Book Is For
Ideal for software developers who need to create documentation alongside code, or for technical writers, developer advocates, product managers, and other technical roles that create and contribute to documentation for their products and services.
Read more
Additional information
| Publisher | 1st ed. edition (1 Oct. 2021), Apress |
|---|---|
| Language | English |
| Paperback | 250 pages |
| ISBN-10 | 1484272161 |
| ISBN-13 | 978-1484272169 |
| Dimensions | 15.49 x 1.45 x 23.5 cm |
by PETER
I ordered this book as our organisation is putting in lot of effort in documentation and hoped that this book would guide me in that. It might be useful for people who have not written much code or documentation before, but for me it didn’t seem to offer anything new.
It is shockingly thin, especially considering the line spacing and the font size. There doesn’t seem to be any discussion or nuance, just do this followed by that.
Usually I wouldn’t have left a review, but I bought this book on the basis of the review, and could have done with a more critical review at the time. Would not recommend this book.
by Mr B.
This is a must read for anyone with any kind of technical background whether that’s developers (as called out in the title), product managers, or any of the other experts who go into making great software products for users.
This really changed the way I thought about documentation and I’ve been doing it for ages.
So I guess you really can teach an old doc new tricks!