Add section on Atomic Commits

alphagov · Mar 21, 2022 · 0017f21 · 0017f21
1 parent 605caac
commit 0017f21
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/source/standards/source-code/working-with-git.html.md.erb b/source/standards/source-code/working-with-git.html.md.erb
@@ -31,6 +31,12 @@ You can configure some CI systems to check out the default branch rather than ha
 
 ## Commits
 
+### Atomic commits
+
+Each commit should be atomic, meaning that each commit should only include changes that achieve a given, granular, step.
+They should also be logical steps that follow each other. As Anna Shipman describes it,
+[they should tell a story](https://www.annashipman.co.uk/jfdi/good-pull-requests.html#make-the-pull-request-tell-a-story).
+
 ### Commit messages
 
 Writing good commit messages is important. Not just for yourself, but for other