Comment Ecrire une demande ?

Parlons des

User stories !

Comment écrire une U.S. ?
1/2
  • La matrice Rôle-Fonctionnalité-Bénéfice est recommandé pour rédiger une User Story
    • En tant que <rôle>
    • Je veux que <fonctionnalité>
    • Afin de <bénéfice>
  • Par exemple
    • En tant qu'analyse sur le backoffice
    • Je veux récupérer la liste des contrats avec révision de la gamme santé
    • Afin de comparer le champ 564951 à la valeur 8
Comment écrire une U.S. ?
2/2
  • Cette formulation permet
    • d'équilibrer les préoccupations
    • de savoir
      • pour qui
      • afin de satisfaire quel objectif                                                   
  • Il en existe de nombreuses variantes :                                                
    • En tant que <rôle> sur <produit>,

    • J'<action> sur/dans/... <entité/complément>,

    • afin de <bénéfice>

  • Exemple : En tant qu'analyse sur backoffice, j'exporte la liste des utilisateurs inscrit sur LTA, afin de leur envoyer un mail

Comment évaluer une U.S. ?
  • On peut juger de la qualité d'une U.S. avec les pivots suivants :
    • Indépendante des autres
    • Négociable, plutôt qu'un engagement ferme
      • demande  générale
    • Verticale, ou ayant de la valeur en soit
      • demande implique une évolution du pro(jet|duit)
    • Evaluée en termes de complexité relative
      • demande précise et comprise
    • Suffisamment petite (Small)
    • Testable, ce qu'on vérifie en écrivant un test 

Parlons des Demandes de correction evolution

Protocole de tests
1/2
  • Avant de traiter une demande, nous avons besoin du cas attendu
  • Pour définir notre test fonctionnel, utilisons la méthode suivante
    • Given : Etant donné un contexte,
    • When : Lorsque l'utilisateur effectue certaines actions
    • Then : Alors on doit pouvoir constater telles conséquences
  • Par exemple:
    • Etant donné un solde positif de mon compte,
    • Lorsque je retire un montant inférieur à la limite de retrait,
    • Alors mon retrait doit se dérouler sans erreur
Protocole de tests
2/2
  • Nous pouvons agrémenter notre demande par :
    • la cas d'echec constaté 
      • ajouter "malheureusement, un avertissement est affiché" à l'exemple précédent
    • des urls indiquants
      • les endroits où le soucis / évolution est demandé
    • des données permettant de voir l'ensemble des cas
      • quand ça fonctionne (ou pas)
Démarche d'analyse
1/2
  • Une liste de questions systématique et exhaustif qui permettent de générer le contexte
    • Qui ?  De qui, Avec qui, Pour le compte de qui…
      • Responsable, acteur, sujet, cible, rôle, compte, identifiant…
    • Quoi ?  Quoi, Avec quoi, en relation avec quoi…    
      • Outil, objet, résultat, objectif, contrat, gamme, …
    • Où ?     Où, par où, vers où…     
      • Lieu, service, application, module, …
    • Quand ?     tous les quand, à partir de quand, jusqu'à quand… 
      • Dates, périodicité, durée…
Démarche d'analyse
2/2
  • suite ...
    • Comment ?  de quelle façon, dans quelles conditions, par quel procédé…     
      • Procédure, technique, action, moyens matériel…
    • Combien ? Dans quelle mesure, valeurs en cause…     
      • Quantités, répétition…
    • Pourquoi ? Cause, facteur déclenchant     
      • Justification par les causes qui ont amené à… (la « raison » d'être, la croyance)
    • Pour quoi ?     Motif, finalité, objectif   
      •  Justification par le souhait, l'ambition, la prévision…
Exemple d'un ticket "parfait"

correction

  • Demande
    • Etant administrateur sur broadcast pour le broadcast HSBC,
    • Lorsque j'exporte les statistiques de connexion du 21/06/2015 au 12/11/2016,
    • Alors mon export dans un fichier excel devrait afficher plusieurs lignes
    • Malheureusement, il n'en contient qu'une
  • Compléments
    • url : http://domain.tld/export/list
    • identiant/mot de passe : bobby/wallace
    • échec constaté : le 13/11/2016
Exemple d'un ticket "parfait"

évolution

  • Demande
    • Etant administrateur sur broadcast pour le broadcast HSBC,
    • Lorsque j'exporte les statistiques de connexion du 21/06/2015 au 12/11/2016,
    • Alors mon export dans un fichier excel doit afficher l'identifiant de l'utilisateur qui s'est connecté
  • Compléments
    • url : http://domain.tld/export/list
    • identiant/mot de passe : bobby/wallace
    • l'identifiant du client doit apparaître dans la colonne extra1

Petits Rappels

La note du chef
  • Une demande limpide sera
    • beaucoup plus facilement priorisé
    • et réalisable
  • Entre ce qu'il y a dans la tête du demandeur et les doigts du développeur,
    • il existe pas mal de biais et de risque d'incompréhension
Pourquoi écrire une demande ?
  • Moyen de
    • communications
    • traçabilité  
  • Cela permet de gagner :
    • en clarté
    • en efficacité
    • en temps 
  • Améliorer la productivité + qualité
    • Diminution des allers-retours donc des incompréhensions possibles
    • ==> Donc amélioration de la satisfaction globale
Une idée de la demande parfaite

A compléter

AVEZ-VOUS DES questions ?

Comment écrire une demande ?

By Robin Duval

Comment écrire une demande ?

Sir on en a gros... Voilà le mot d'ordre des équipes de développements lorsqu'une demande est mal formulé... face à ce problème constant, il a été décidé de communiquer sur la manière d'effectuer des demandes.

  • 416