doc tweaks

Author: dchelimsky

features/filtering/inclusion_filters.feature

@@ -1,18 +1,17 @@
 Feature: inclusion filters
 
-  You can restrict which examples are run by declaring an inclusion filter. The
+  You can constrain which examples are run by declaring an inclusion filter. The
   most common use case is to focus on a subset of examples as you're focused on
   a particular problem.
 
-  If you set the `treat_symbols_as_metadata_keys_with_true_values` config option
-  to `true`, you can specify metadata using only symbols.
+  You can specify metadata using only symbols if you set the
+  `treat_symbols_as_metadata_keys_with_true_values` config option to `true`.
 
   Background:
     Given a file named "spec/spec_helper.rb" with:
       """
       RSpec.configure do |c|
-        # filter_run is short-form alias for filter_run_including
-        c.filter_run :focus => true
+        c.filter_run_including :focus => true
       end
       """
 

features/hooks/filtering.feature

@@ -1,12 +1,21 @@
 Feature: filters
 
-  `before`/`after`/`around` hooks defined in the RSpec configuration block can
-  be filtered using metadata.  Arbitrary metadata can be applied to an example
-  or example group, and used to make a hook only apply to examples with the
-  given metadata.
+  `before`, `after`, and `around` hooks defined in the block passed to
+  `RSpec.configure` can be constrained to specific examples and/or groups using
+  metadata as a filter.
 
-  If you set the `treat_symbols_as_metadata_keys_with_true_values` config option
-  to `true`, you can specify metadata using only symbols.
+      RSpec.configure do |c|
+        c.before(:each, :type => :model) do
+          # ...
+        end
+      end
+
+      describe "something", :type => :model do
+        # ...
+      end
+
+  You can specify metadata using only symbols if you set the
+  `treat_symbols_as_metadata_keys_with_true_values` config option to `true`.
 
   Scenario: filter `before(:each)` hooks using arbitrary metadata
     Given a file named "filter_before_each_hooks_spec.rb" with: