Cucumber features as documentation
Cucumber allows for prose in features and scenarios. Example:
Feature: Cancel account There are several ways to cancel a user account. Admins need to do it in complex cases, but normally, users can do it themselves. Scenario: User cancels his own account Users should be able to cancel an account themselves, so the admins do not need to do it. Given a user account for "email@example.com" When I sign in as "firstname.lastname@example.org" And I follow "Cancel account" Then I should see "Account canceled"
By going beyond the single line descriptions we've accustomed to, we can provide all the information that is required to understand the intention and meaning of a feature/scenario. That way, future developers can quickly get an understanding of the application.