Chapter Thirteen

The Human Side: Documentation, Communication & Teamwork

Software is built by people, for people, and the human skills matter as much as the technical ones. This chapter covers the parts of the job that aren't code: documentation that's actually useful, recording the big decisions, communicating clearly (especially in writing and to non-engineers), and spreading knowledge so no one on the team is irreplaceable.

4 topics

By now you've seen how software is built and run. But none of it happens in isolation: it's the work of people coordinating, explaining, deciding, and teaching each other. The most senior developers will tell you these human skills, not raw coding, are what their careers came to be about.

Four topics. First, documentation that earns its keep — the kinds people actually use. Then recording the big, hard-to-reverse decisions so future teams know why. Then communicating well — especially in writing, and with people who aren't engineers. And finally spreading skill and knowledge across a team, so it's resilient and no single person is a bottleneck.

The human skills around the code
Write it down usefully
READMEs, API docs, runbooks
Record the why
decisions on the record (ADRs)
Communicate clearly
async, and with non-engineers
Spread the knowledge
feedback, pairing, no single point of failure

Topics in This Chapter