liveBook · Manning

Atomic change

As explained in "Looks Good to Me"

A software change that forms a self-contained unit of work with a narrowly focused purpose.

An atomic change is a narrowly focused, self-contained unit of work. In practice, it produces a smaller pull request with fewer files, fewer lines, and less cognitive overhead for reviewers. section 9.2.2

Making review feasible

When a team says it has no time for code reviews, split planned, designed, and developed work into smaller changes. Treat the resulting review as required work rather than leaving it as an optional safeguard. section 9.2.2

Teams can protect time for reviewing atomic changes by:

How "Looks Good to Me" covers it

How deep it goes
Explains the review benefits and planning tactics but does not specify implementation-level change boundaries.
Examples
Uses smaller pull requests, reduced file and line counts, review tasks, and dedicated review hours.
What it assumes
Assumes familiarity with pull requests and code reviews while emphasizing their required place in team planning.
What you can do after
Apply it by planning and delivering smaller changes that reviewers can assess quickly.
How it connects
Links atomic changes with pull requests, code review, planning, and technical debt.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of "Looks Good to Me". The section links point to the parts of the book it draws on.