Merge pull request #2629 from pirj/fix-described_class-in-nested-examples-doc

Fix documentation for nested described_class

Author: myronmarston

features/metadata/described_class.feature

@@ -1,17 +1,20 @@
 Feature: described class
 
-  If the first argument to the outermost example group is a class, the class is
-  exposed to each example via the `described_class()` method.
+  If the first argument to an example group is a class, the class is exposed to
+  each example in that example group via the `described_class()` method.
 
   Scenario: Access the described class from the example
     Given a file named "spec/example_spec.rb" with:
       """ruby
       RSpec.describe Fixnum do
-        it "is available as described_class" do
-          expect(described_class).to eq(Fixnum)
+        describe 'inner' do
+          describe String do
+            it "is available as described_class" do
+              expect(described_class).to eq(String)
+            end
+          end
         end
       end
       """
     When I run `rspec spec/example_spec.rb`
     Then the example should pass
-

features/subject/implicit_subject.feature

@@ -1,7 +1,8 @@
 Feature: implicitly defined subject
 
-  If the first argument to the outermost example group is a class, an instance
-  of that class is exposed to each example via the `subject` method.
+  If the first argument to an example group is a class, an instance of that
+  class is exposed to each example in that example group via the `subject`
+  method.
 
   While the examples below demonstrate how `subject` can be used as a
   user-facing concept, we recommend that you reserve it for support of custom