README.rdoc

Zebra

The problem

context "A blog post" do
setup do
@author = create_person
@post = create_post :author => @author
end
should "be editable by its author" do
assert @post.editable_by?(@author)
end
end

Don't see the problem?

Why bother writing self-documenting test code if you always have to explain
it to the reader? Test
names are essentially glorified comments and comments
are frequently code smells. Furthermore, all the extra code required to
create a test (should “” do … end) almost certainly discourages one
assertion per test. If the assertion is one line and the code can explain
itself, why bother with all the other crap?

The right tool for the job

The cool thing about zebra is that it's an extension to test/unit. If
you have a test that belongs in a should block, with a big, old-fashioned
test name, you can have it. Just use should or it. When you have a short,
self-documenting test, use expect. Best of both worlds.