News for hackers. Stuff that matters.

Ask HN: What are some good books about non-code elements of software?

I'm thinking of a book like Working Effectively With Legacy Code but that deals more with things like documentation, specification, code review, etc. I'd like the book to help with the following scenario: given some completely "naked" codebase, what things (whether they're specs, docs, comments, whatever) need to be added to the codebase before you'd consider it "high-quality"?
( 11 comments | 8 points | on HN )
Re:Ask HN: What are some good books about non-code elements ... by mssundaram on Tuesday April 06, 2021 @09:02PM (#26719373)
"The Pragmatic Programmer" may be useful to you. It's dated but still relevant, and it was recently revised.
Re:Ask HN: What are some good books about non-code elements ... by idolaspecus on Wednesday April 07, 2021 @11:38AM (#26726460)
This is one of those books I’ve always meant to read but never have. I guess the time is now. Thanks for the suggestion.
Re:Ask HN: What are some good books about non-code elements ... by mssundaram on Wednesday April 07, 2021 @03:02PM (#26729435)
There is an Audible version as well
Re:Ask HN: What are some good books about non-code elements ... by ElectricMind on Friday April 09, 2021 @09:38AM (#26750408)
I suggest "Making better software" documentary on Amazon Prime by Joel Spolsky. Also you can read his blog on [0]

Huge respect for him. Kind of dream manager you want :)

[0] https://www.joelonsoftware.com/

Re:Ask HN: What are some good books about non-code elements ... by macando on Wednesday April 07, 2021 @03:57AM (#26721661)
"Clean Architecture" by Robert C. Martin.
Re:Ask HN: What are some good books about non-code elements ... by 100011_100001 on Wednesday April 07, 2021 @01:06PM (#26727708)
I would add Clean Code. It's Java centric but a lot of the ideas can be used in any language, even though it can probably all be condensed to "everything should do a single thing and no more"
Re:Ask HN: What are some good books about non-code elements ... by macando on Wednesday April 07, 2021 @02:13PM (#26728699)
Yeah, single responsibility principle is the key takeaway from that book. Clean Code is a must for all programmers and I can recommend it as a prequel to CA. It's written by the same author after all.

I have a feeling the OP is looking for a book about software development in a broad sense.

Re:Ask HN: What are some good books about non-code elements ... by yuppie_scum on Tuesday April 06, 2021 @09:20PM (#26719470)
Honestly, the Google SRE book as well.
Re:Ask HN: What are some good books about non-code elements ... by sloaken on Wednesday April 07, 2021 @06:09AM (#26722678)
Based on your entry, I looked it up and found this page with 3 (FREE) books: https://sre.google/books/
Re:Ask HN: What are some good books about non-code elements ... by 100011_100001 on Wednesday April 07, 2021 @01:05PM (#26727697)
Not the person that you replied to, but he probably means the book on the right. It's a good recommendation especially if you are trying to understand how and why DevOps / SRE works and why it's important.
Re:Ask HN: What are some good books about non-code elements ... by yuppie_scum on Tuesday April 06, 2021 @09:20PM (#26719465)
The Phoenix Project