[refs rspec/rspec-core#1433] Fixed docs; rewritten feature.