diff --git a/doc/ci/yaml/README.md b/doc/ci/yaml/README.md
index 808a23df554..e12ef6e2685 100644
--- a/doc/ci/yaml/README.md
+++ b/doc/ci/yaml/README.md
@@ -1145,7 +1145,7 @@ case of a failure.
 When a job fails, and has `retry` configured it is going to be processed again
 up to the amount of times specified by the `retry` keyword.
 
-If `retry` is set to 3, and a job succeeds in a second run, it won't be retried
+If `retry` is set to 2, and a job succeeds in a second run (first retry), it won't be retried
 again. `retry` value has to be a positive integer, equal or larger than 0, but
 lower or equal to 2 (two retries maximum, three runs in total).
 
@@ -1154,7 +1154,7 @@ A simple example:
 ```yaml
 test:
   script: rspec
-  retry: 3
+  retry: 2
 ```
 
 ## Git Strategy
diff --git a/spec/models/ci/build_spec.rb b/spec/models/ci/build_spec.rb
index acfc888d944..0b521d720f3 100644
--- a/spec/models/ci/build_spec.rb
+++ b/spec/models/ci/build_spec.rb
@@ -826,10 +826,10 @@ describe Ci::Build, :models do
 
     describe '#retries_max' do
       context 'when max retries value is defined' do
-        subject { create(:ci_build, options: { retry: 3 }) }
+        subject { create(:ci_build, options: { retry: 1 }) }
 
         it 'returns a number of configured max retries' do
-          expect(subject.retries_max).to eq 3
+          expect(subject.retries_max).to eq 1
         end
       end