Clarify pending docs
Created by: pirj
A summary of what is done here:
- Replaced a confusing "an example" docstring of a
describe
statement:
- describe "an example" do
+ describe "some behaviour" do
- Removed the misleading notion of a possibility to bypass hooks for any notation of a pending example:
- #`before(:example)` hooks are eval'd when you use the `pending`
- # method within an example. If you want to declare an example `pending`
- # and bypass the `before` hooks as well,
just because hooks are run either way.
- Wrapped the example of
pending
example group alias intodescribe
to make a distinction betweenpending
example alias andpending
example-scope method:
it "is pending with no message" do
pending
end
vs
describe "SomeClass" do
pending "does not implement something yet" do
# ...
end
end
- Clarified the difference between different applications of
pending
when the failure happens insidebefore
hook.
See the discussion: