StackOverflow2013

Note that there are some explanatory texts on larger screens.

plurals

PO
text
Body
copied!<p>It's fine either way, but there is a subtle difference.</p> <p>I sometimes like to phrase things in the first person if the benefit of the outcome is for the user, and the third person if it's for someone other than the user.</p> <p>For instance, you might have a story:</p> <pre><code>In order to prevent bots from spamming the site As a moderator I want users to prove that they are human. </code></pre> <p>And the associated scenario could either read:</p> <pre><code>Given a user is not registered When they try to register Then they should be presented with a CAPTCHA When they fill in the CAPTCHA Then they should be successfully registered </code></pre> <p>Or:</p> <pre><code>Given I am not registered When I try to register Then I should be presented... what, wait, no, I shouldn't! </code></pre> <p>In this instance, it's obvious that there's a cognitive disconnect with the idea that "I should be presented with a CAPTCHA", since they're annoying and nobody wants them. Putting this scenario in the third person makes it apparent that the benefit may not be for that person.</p> <p>I occasionally make up names for the users - Ursula Usual for a normal user and Andy Admin for an admin, for instance. Using the third person this way can also be useful for calling out different personas and roles.</p> <p>There are other scenarios in which the role is the same, but two different people play it.</p> <pre><code>Given Doctor Donald has filled out Priscilla Patient's prescriptions When Doctor Diana looks for her file // <-- different doctor! Then she should be able to find those prescriptions. </code></pre> <p>In the case in which other actors can use the same function, the context of their roles or permissions will be changing the behavior, and that context should be included in the scenario anyway, even if it's just implicit in their names.</p>

Querying!

Guidance

An individual column

Larger individual text columns get their own page to allow for proper reading.

SQuiL has stopped working due to an internal error.

If you are curious you may find further information in the browser console, which is accessible through the devtools (F12).

Reload