
Docs for Developers
Jared Bhatti, Heidi Waterhouse · 2021
Programming and computer science › Software design and clean code
#5,159 most recommended
Hacker News
10
mentions by 7 people · top 29% of 15,732 books
Open Library
4.00★★★★★★★★★★
1 rating · 6 want to read
Wikipedia
—
No article yet
About the book
A practical guide to writing developer documentation as part of the software development lifecycle, covering user research, friction logs, READMEs, API references, tutorials, conceptual material, release notes, information architecture for search, publishing, and analytics-based measurement. It follows a fictional team of developers as they launch a new product, with templates and principles meant to be adapted to other organizations. Documentation is a core engineering concern rather than an afterthought, and writing and programming share enough craft that developers can learn to do both well. Poor documentation reduces developer productivity, limits a project's scalability and adoption, and hurts accessibility, so it can sink a project. The guide's remedy is to build documentation into each stage of development, starting from understanding users' frustrations and continuing through publishing, measurement, and maintenance alongside regular code releases.
Written by Claude from what it knows of this book.
What Hacker News says 57% recommend · 0% critical
In the commenters’ own words
Hi, I have two suggestions. First, I sense that you should keep work on improving your mastery of English grammar. I have a few resources for that: *…
I am in the same boat and am interested in the same type of books! If you'd like to have some accountability and some sort of light book club kind of thing…
What Open Library readers say 4.00 from 1 rating
- 50
- 41
- 30
- 20
- 10
- 6 want to read
- 1 reading
- 1 have read
Only 1 rating: treat the average as a hint.
What critics say, via Wikipedia
No Wikipedia article about this book yet, so no critics to quote.
Reddit communities — coming later
The threads it came up in
Details
- First published
- 2021
- ISBN
- 9781484272169
- Editions known
- 5 at Open Library
- Open Library
- OL24645251W
Read next: its neighbours on the mosaic
Developing quality technical informationGretchen Hargis · 2004 · recommended by 3 people · similar by subject and what people say about it
Software Engineering at GoogleTitus Winters · 2020 · recommended by 21 people · similar by subject and what people say about it
Web design for developersBrian P. Hogan · 2009 · recommended by 4 people · similar by subject and what people say about it
Soft SkillsJohn Z. Sonmez · 2015 · recommended by 14 people · similar by subject and what people say about it
Too big to knowDavid Weinberger · 2012 · recommended by 1 person · loosely similar by subject
Dynamics of software developmentMcCarthy, Jim · 1995 · recommended by 10 people · similar by subject and what people say about it
The Elements of StyleWilliam Strunk, Jr. · 1918 · recommended by 131 people · 2 people recommended both
Design for DevelopersStephanie Stimac · 2023 · recommended by 2 people · similar by subject and what people say about it
Designing Data-Intensive ApplicationsMartin Kleppmann · 2017 · recommended by 457 people · similar by subject and what people say about it
The DevOps handbookGene Kim · 2016 · recommended by 22 people · similar by subject and what people say about it
How Google Tests SoftwareJames A. Whittaker · 2012 · recommended by 3 people · similar by subject and what people say about it
The Software CraftsmanSandro Mancuso · 2014 · recommended by 9 people · similar by subject and what people say about it
The Art of Readable CodeDustin Boswell · 2011 · recommended by 11 people · similar by subject and what people say about it
Software CraftsmanshipPete McBreen · 2001 · recommended by 4 people · similar by subject and what people say about it
Beautiful CodeAndy Oram · 2007 · recommended by 48 people · similar by subject and what people say about it
Exercises for ProgrammersBrian P. Hogan · 2015 · recommended by 6 people · similar by subject and what people say about it
Ask Your DeveloperJeff Lawson · 2021 · recommended by 3 people · similar by subject and what people say about it
The Pragmatic ProgrammerAndy Hunt · 1999 · recommended by 353 people · similar by subject and what people say about it
Letting go of the wordsJanice Redish · 2012 · recommended by 6 people · similar by subject and what people say about it
Team GeekBen Collins-Sussman · 2012 · recommended by 11 people · similar by subject and what people say about it
An Elegant PuzzleWill Larson · 2019 · recommended by 41 people · similar by subject and what people say about it
Software Developer's Career HandbookMichael Lopp · 2022 · recommended by 3 people · similar by subject and what people say about it
The passionate programmerChad Fowler · 2011 · recommended by 31 people · similar by subject and what people say about it
Working with codersPatrick Gleeson · 2017 · recommended by 1 person · similar by subject and what people say about it