fixup! Clarify difference in pending usage

Author: pirj

lib/rspec/core/pending.rb

@@ -71,6 +71,23 @@ class PendingExampleFixedError < StandardError; end
       #     it "does something", :pending do
       #       # ...
       #     end
+      #
+      # @note There is a difference between using `pending` inside the example
+      # body and `pending` example group alias/`pending` metadata. In the case
+      # when the failure is caused by the code in the `before` hook, the example
+      # would not be considered pending, as the example body wouldn't be reached.
+      # If you intend the failure in the `before` hook to be considered a part
+      # of the example, use the latter.
+      #
+      # @example Failure in `before` hook causes the example to fail
+      #     before { fail 'BOOM' }
+      #     it 'fails' do
+      #       pending 'this never gets executed'
+      #     end
+      #
+      #     pending 'is considered pending' do
+      #       not_implemented
+      #     end
       def pending(message=nil)
         current_example = RSpec.current_example