✎ sdd:langage_gherkhin [pdc2]

<h1 class="page-header pb-3 mb-4 mt-5"><svg viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" role="presentation" class="iconify mr-2"><path d="M13 9h5.5L13 3.5V9M6 2h8l6 6v12a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V4c0-1.11.89-2 2-2m9 16v-2H6v2h9m3-4v-2H6v2h12z"/></svg> Les bases de la rédaction en Gherkin</h1>
<div class="level1">

<p>
Issu de la pratique du <b>Behavior Driven Development (BDD)</b>, le langage <b>Gherkin</b> est très souvent associé aux projets agiles car il permet de décrire de manière cohérente les comportements d'un utilisateur.
</p>

<p>
Il peut être utilisé par le <b>Product Owner</b>, le <b>QA Agile</b> et les <b>développeurs</b>. Son objectif est de créer une documentation homogène grâce à des règles de rédaction communes.
</p>

</div>

<h2 class="page-header pb-3 mb-4 mt-5">Qu'est-ce que le langage Gherkin ?</h2>
<div class="level2">

</div>

<h3 class="page-header pb-3 mb-4 mt-5">Pourquoi utiliser le langage Gherkin ?</h3>
<div class="level3">

<p>
L'un des enjeux majeurs d'un projet agile est d'assurer une communication claire et efficace entre le Product Owner, les développeurs et les QA.
</p>

<p>
Le Gherkin répond à ce besoin en proposant un langage compréhensible par tous les intervenants du projet.
</p>

<p>
Les discussions sont alors centrées sur les comportements attendus de l'utilisateur plutôt que sur une succession de règles techniques.
</p>

</div>

<h3 class="page-header pb-3 mb-4 mt-5">Utilisation dans une organisation agile</h3>
<div class="level3">

<p>
Le langage Gherkin est utilisé par :
</p>
<ul class="fix-media-list-overlap">
<li class="level1"> Le Product Owner pour rédiger les User Stories.</li>
<li class="level1"> Le QA Agile pour rédiger les critères d'acceptation et les scénarios de test.</li>
<li class="level1"> Les développeurs et automaticiens pour automatiser les tests.</li>
</ul>

<p>
Le Gherkin devient ainsi un langage commun à l'ensemble de l'équipe.
</p>

</div>

<h3 class="page-header pb-3 mb-4 mt-5">Comment écrire en Gherkin ?</h3>
<div class="level3">

<p>
Le langage Gherkin est structuré par lignes et mots-clés :
</p>
<ul class="fix-media-list-overlap">
<li class="level1"> Une ligne commence par un mot-clé.</li>
<li class="level1"> Un mot-clé représente une étape du comportement utilisateur.</li>
<li class="level1"> Une ligne = un mot-clé.</li>
</ul>

</div>

<h2 class="page-header pb-3 mb-4 mt-5">Les mots-clés fondamentaux</h2>
<div class="level2">

<p>
Les trois mots-clés principaux sont utilisés dans cet ordre :
</p>
<pre class="code">Given
When
Then

</pre><p> </p>
<ul class="fix-media-list-overlap">
<li class="level1"> <b>Given (Étant donné)</b> : décrit le contexte initial.</li>
<li class="level1"> <b>When (Lorsque)</b> : décrit l'action réalisée par l'utilisateur.</li>
<li class="level1"> <b>Then (Alors)</b> : décrit le résultat attendu.</li>
</ul>

</div>

<h2 class="page-header pb-3 mb-4 mt-5">Les mots-clés complémentaires</h2>
<div class="level2">
<ul class="fix-media-list-overlap">
<li class="level1"> <b>And (Et)</b> : ajoute une condition.</li>
<li class="level1"> <b>But (Mais)</b> : exclut ou précise une condition.</li>
</ul>

</div>

<h2 class="page-header pb-3 mb-4 mt-5">Les mots-clés de structuration</h2>
<div class="level2">
<ul class="fix-media-list-overlap">
<li class="level1"> <b>Feature (Fonctionnalité)</b> : décrit la fonctionnalité ou la User Story.</li>
<li class="level1"> <b>Scenario</b> : décrit un comportement attendu spécifique.</li>
</ul>

</div>

<h2 class="page-header pb-3 mb-4 mt-5">Les règles à respecter</h2>
<div class="level2">

</div>

<h3 class="page-header pb-3 mb-4 mt-5">La règle d'or</h3>
<div class="level3">

<p>
Toute personne, même étrangère au projet, doit comprendre le comportement décrit sans avoir besoin d'explications supplémentaires.
</p>

<p>
Si ce critère est respecté, la rédaction remplit pleinement son objectif.
</p>

</div>

<h3 class="page-header pb-3 mb-4 mt-5">Les trois règles fondamentales</h3>
<div class="level3">

</div>

<h4>1. Un découpage clair</h4>
<div class="level4">
<ul class="fix-media-list-overlap">
<li class="level1"> 1 User Story = 1 fonctionnalité.</li>
<li class="level1"> 1 scénario = 1 comportement.</li>
</ul>

<p>
Si un scénario contient plusieurs ensembles de :
</p>
<pre class="code">Given
When
Then

</pre><p> </p>

<p>
il est souvent préférable de le découper en plusieurs scénarios.
</p>

</div>

<h4>2. Une syntaxe lisible</h4>
<div class="level4">
<ul class="fix-media-list-overlap">
<li class="level1"> Respecter l'ordre : <b>Given → When → Then</b>.</li>
<li class="level1"> Utiliser <b>And</b> et <b>But</b> lorsque nécessaire.</li>
<li class="level1"> Éviter le vocabulaire technique et le code.</li>
<li class="level1"> Utiliser l'indentation pour améliorer la lisibilité.</li>
</ul>

</div>

<h4>3. Des titres de scénarios clairs</h4>
<div class="level4">

<p>
Des titres explicites permettent :
</p>
<ul class="fix-media-list-overlap">
<li class="level1"> De vérifier rapidement la pertinence du scénario.</li>
<li class="level1"> D'identifier les doublons.</li>
<li class="level1"> De faciliter la maintenance.</li>
</ul>

<p>
<b>Conseil :</b> limiter le nombre de scénarios à environ 5 par User Story.
</p>

</div>

<h2 class="page-header pb-3 mb-4 mt-5">Exemple de rédaction Gherkin</h2>
<div class="level2">

</div>

<h3 class="page-header pb-3 mb-4 mt-5">Cas de test classique</h3>
<div class="level3">

<p>
Exemple :
</p>

<p>
Une personne souhaite acheter le tome 1 d'Harry Potter sur un site e-commerce nommé <code>Fleury&Bott.com</code>.
</p>

</div>

<h3 class="page-header pb-3 mb-4 mt-5">Transformation en Gherkin</h3>
<div class="level3">

<p>
Pour améliorer la lisibilité, le comportement peut être découpé en deux scénarios :
</p>
<ul class="fix-media-list-overlap">
<li class="level1"> Recherche d'un produit via la barre de recherche.</li>
<li class="level1"> Accès à la fiche produit.</li>
</ul>

<p>
Exemple :
</p>
<pre class="code gherkin">Feature: Recherche d'un livre
 
  Scenario: Recherche du tome 1 d'Harry Potter
    Given que l'utilisateur est sur la page d'accueil
    When il saisit "Harry Potter Tome 1" dans la barre de recherche
    Then les résultats correspondant à sa recherche sont affichés
 
  Scenario: Consultation de la fiche produit
    Given que les résultats de recherche sont affichés
    When l'utilisateur sélectionne le tome 1 d'Harry Potter
    Then la fiche détaillée du produit est affichée

</pre><p> </p>

</div>

<h2 class="page-header pb-3 mb-4 mt-5">Conclusion</h2>
<div class="level2">

<p>
Le langage Gherkin permet :
</p>
<ul class="fix-media-list-overlap">
<li class="level1"> D'établir des règles de rédaction communes.</li>
<li class="level1"> D'être compris par toutes les parties prenantes.</li>
<li class="level1"> De décrire les comportements utilisateurs attendus.</li>
<li class="level1"> De faciliter la communication entre les équipes agiles.</li>
</ul>

</div>

Autoriser les tableaux complexes Hauteur de l'éditeur : px Activer la prise en charge supplémentaire du coller d'image Marche

Résumé: Changements mineurs