Document repeated tests with bisect command

Author: benoittgt

spec/integration/bisect_spec.rb

@@ -34,9 +34,13 @@ def bisect(cli_args, expected_status=nil)
     end
 
     context "when the bisect command is long" do
+      # On OSX and Linux when we have many tests we could had pipe size issue. We did not empty the buffer
+      # and we ended up with a pipe that was full and it was blocking the main process. This made the bisect
+      # command stuck without further information. This test run blocking_pipe_bisect_spec.rb_ that
+      # will ensure that we are not blocked anymore in this kind of situation.
+      # https://github.com/rspec/rspec-core/pull/2669
       it 'does not hit pipe size limit and does not get stuck' do
         output = bisect(%W[spec/rspec/core/resources/blocking_pipe_bisect_spec.rb_], 1)
-        puts output
         expect(output).to include("No failures found.")
       end
     end