rspec/rspec-core — Issue #493: Add API for managing aliases of `describe`
Author: dchelimsky
Created: 2011-11-01 15:18:32+00:00
State: open

rspec-core has configuration APIs for managing aliases for `example` (e.g. `it`) and `shared_examples` (e.g. `it_behaves_like`), but there is no such API for managing aliases for `describe` (which should be renamed to `example_group` and then aliased as `describe` and `context`).

As of 2.7, `describe` is available at all levels, but `context` is only available within an example group declaration.

I'd propose something along the lines of this:

```ruby
RSpec.configure do |c|
c.alias_example_group_to :describe, :top_level => true
c.alias_example_group_to :context, :top_level => false
end
```

We should also be able to turn off all top-level names if we want, so users concerned with `describe`, `context`, et al bleeding into their code can say:

``` ruby
RSpec.describe Thing do
it "does something"
end
```