Wie man User Stories mit der Gherkin-Sprache beschreibt

DEFINITION EINER USER STORY

Eine User Story ist eine in Alltags- oder Geschäftssprache verfasste Beschreibung einer Funktionalität oder eines Teils einer Funktionalität, die festhält, was ein Benutzer tut oder tun muss.

User Stories bieten eine schnelle Möglichkeit, Kundenanforderungen anstelle von formalen Anforderungsdokumenten zu bearbeiten, ohne dass administrative Aufgaben im Zusammenhang mit ihrer Pflege anfallen.

BENEFITS

Spezialisten unseres Unternehmens haben die Vorteile der Verwendung von User Stories für jedes Mitglied des Agile-Teams formuliert:

FÜR PROJEKTMANAGER:

  • Es hilft, die Anwendungsarchitektur korrekt zu erstellen;
  • Es reduziert die Zeit für die Beantwortung von Fragen zur Logik der Anwendung an Entwickler, Designer, Tester;
  • Es kann als Dokumentation verwendet und leicht aktualisiert werden;

FÜR DESIGNER:

  • Es gibt einen Einblick in die Anzahl der Mock-Ups, die benötigt werden, um das gesamte Layout der Anwendung abzudecken;
  • Es warnt vor überflüssigen oder fehlenden bestimmten Bildschirmen / Schaltflächen / Funktionen;

FÜR ENTWICKLER:

  • Funktionen sind die Grundlage für das Schreiben von Akzeptanztests bei testgetriebener Entwicklung (TDD und BDD);
  • Es hilft, Missverständnisse in der Dokumentation (Spezifikationen und Anforderungen des Kunden) und Fehler in der Logik der Anwendung zu vermeiden;

FÜR QA:

  • Es dient als Grundlage für das Schreiben von Testfällen und Testszenarien;
  • Es hilft, die Logik der Anwendung schnell zu verstehen;

FÜR KUNDEN:

  • Gibt ein gutes Verständnis für eine Anwendung und ihre Funktionsweise;
  • Der Kunde kann die neue Funktionalität beschreiben, indem er unser User-Story-Format verwendet, das Fehlinterpretationen von Anforderungen verhindert;

FORMATE VON USER STORIES

Auch die folgenden Formate einer User Story können Sie erfüllen:

Mike Cohn, ein bekannter Autor von User Stories, betrachtet die „so that“-Klausel als optional:

„Als eine <Rolle>, Ich will <Ziel/Wunsch>“

Chris Matts schlug vor, dass die „Jagd nach dem Wert“ der erste Schritt zur erfolgreichen Auslieferung von Software ist, und schlug diese Alternative als Teil der Feature Injection vor:

„Um <Nutzen> als <Rolle> zu erhalten, Ich möchte <Ziel/Wunsch>“

Andere Möglichkeiten:

„Als eine <Rolle>, Ich möchte <Ziel/Wunsch>, damit <Nutzen>“

„Als eine <Rolle>, Ich kann <mit dem System> so agieren, dass <externer Nutzen>“

In der Firma Steelkiwi verwenden wir die Gherkin-Sprache, um eine User Story sowohl für Entwickler als auch für Kunden lesbarer und verständlicher zu machen.

DEFINITION DER GHERKIN-SPRACHE

Gherkin ist eine menschenlesbare Sprache zur Beschreibung des Systemverhaltens, die mit Einrückungen (Leerzeichen oder Tabulatoren) die Struktur des Dokuments definiert. Jede Zeile beginnt mit einem der Schlüsselwörter und beschreibt einen der Schritte.

Die meisten Zeilen in der Gherkin beginnen mit einem speziellen Schlüsselwort und bestehen z. B. aus Funktionen und Szenarien:

Lassen Sie uns das obige Beispiel durchgehen:

1. Merkmal: Eine kurze, aber umfassende Beschreibung der benötigten Funktionalität, die eine Funktion startet und ihr einen Namen gibt.

2. Die nächsten drei Zeilen beschreiben den Nutzen, den wir von dieser Funktion haben werden.

3. Szenario: Eine bestimmte Geschäftssituation beginnt das Skript und enthält eine Beschreibung.

4. Die folgenden 7 Zeilen beschreiben die Testschritte, die einem bestimmten Code entsprechen, der die beschriebene Aktion ausführt. Es werden die Zeilen verglichen, auf die die Schlüsselwörter „Given“, „AND“, „Then“ usw. folgen.

IMPLEMENTATION

Unten, können Sie sehen, wie der erste Teil einer unserer User Stories aussieht:

Benutzeraktionen: Fotos ansehen, Likes setzen, Nachrichten ansehen, Fotos hochladen und an Wettbewerben teilnehmen Als Benutzer möchte ich die Anwendung aus dem App Store herunterladen, mich dann registrieren/anmelden, dann Fotos nach Künstler suchen, Fotos ansehen, Likes setzen, Nachrichten ansehen, mein Foto hochladen, Foto zu Wettbewerben hinzufügen.

1.1. Registrierung: Um mich als nicht autorisierter Benutzer anzumelden, möchte ich die heruntergeladene Anwendung öffnen, dann auf die Schaltfläche „Anmelden“ klicken, alle Pflichtfelder ausfüllen (E-Mail, Passwort usw.), eine Verbindung zu Google+/Facebook/Instagram/Twitter herstellen und Freunde hinzufügen, die in der PhotoCulture-Anwendung registriert sind, und dann zur Startseite zurückkehren.

1.1.1. Anwendung herunterladen: Um die Anwendung aus dem App Store herunterzuladen, öffnen Sie als Benutzer den App Store, klicken Sie auf die Schaltfläche „Suchen“, geben Sie dann „____“ ein und klicken Sie auf die Schaltfläche „Installieren“.

1.1.2. Anmelden: Um mich anzumelden Als nicht autorisierter Benutzer möchte ich eine heruntergeladene Anwendung öffnen, dann auf die Schaltfläche „Anmelden“ klicken, dann zum Bildschirm „Anmelden“ weitergeleitet werden, dann den korrekten Wert in das Feld „E-Mail“ eingeben, den korrekten Wert in das Feld „Kennwort“ eingeben, den Wert in das Feld „Kennwort bestätigen“ duplizieren, dann auf die Schaltfläche „Anmelden“ klicken, dann das Popup-Fenster „Überprüfen Sie Ihre E-Mail, um die Registrierung abzuschließen“ anzeigen, dann die Registrierung in meiner E-Mail bestätigen.

ZUSAMMENFASSUNG

Bevor wir eine individuelle User Story schreiben, erstellen wir die Story, die das End-to-End-Szenario des Anwendungsverhaltens von der Registrierung bis zum Abschluss der Anwendung (Abmeldung) beschreibt. In dieser User Story beschreiben wir alle Aktionen, für die die Anwendung erstellt wurde, z. B. das Betrachten von Fotos anderer Mitglieder durch Hinzufügen eigener Fotos, die Teilnahme an Wettbewerben, das Erhalten von Auszeichnungen, das Schreiben von Kommentaren, usw. Im Folgenden machen wir einzelne User Stories, die bestimmte Funktionalitäten detaillierter beschreiben. Darüber hinaus beschreiben wir bei Bedarf die detaillierteren Teile der vorherigen User Story.

Eine Besonderheit unseres Unternehmens ist, dass wir die User Story nicht von der allgemeinen Struktur des Projekts trennen. Wir bilden alle User Stories aus der Anwendung in einem einzigen Dokument, in dem sie in der Baumstruktur erscheinen.

VORTEILE UNSERES ANSATZES

  • Es hilft, nichtkompatiblen User Stories mit der Anwendungsarchitektur
  • Es zeigt, wie sich die Änderungen auf die Anwendungsstruktur auswirken
  • Es ermöglicht den Kunden, neue Anforderungen und Wünsche für die Entwickler verständlicher zu machen

NUTZENDE LINKS

  1. User Story
  2. Funktionen schreiben – Gurke

Wenn Ihnen dieser Artikel gefällt – mehr interessante Inhalte finden Sie im SteelKiwi Blog!
Wenn Sie Fragen haben – kontaktieren Sie uns!

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert.