diff --git a/doc/development/gotchas.md b/doc/development/gotchas.md
index 5557a113d0524e4e6348d5fb3260d1539785d8b8..cab79b24f94de60ff2b27c5f999a88c365f1a5eb 100644
--- a/doc/development/gotchas.md
+++ b/doc/development/gotchas.md
@@ -114,6 +114,7 @@ Instead of writing:
 # Don't do this:
 expect_any_instance_of(Project).to receive(:add_import_job)
 
+# Don't do this:
 allow_any_instance_of(Project).to receive(:add_import_job)
 ```
 
@@ -125,6 +126,7 @@ expect_next_instance_of(Project) do |project|
   expect(project).to receive(:add_import_job)
 end
 
+# Do this:
 allow_next_instance_of(Project) do |project|
   allow(project).to receive(:add_import_job)
 end