Par Thomas Cohen, fondateur de Maestro
Les règles de votre application méritent aussi d’être conservées
Une remise, une annulation, un accès réservé : ces décisions expliquent votre application. Les garder par écrit facilite les corrections et la reprise du travail.
Prenons un exemple fictif : votre application applique une remise aux clients fidèles. Six mois plus tard, vous changez la règle : 15 % à partir de la troisième commande. Si l’ancienne décision n’existe que dans une conversation oubliée, la personne qui intervient doit d’abord la retrouver, ou la deviner.
Ce qu’on appelle une spécification
Une spécification décrit ce que l’application doit faire dans une situation précise. Ici : quelles commandes comptent, à partir de quand la remise s’applique et sur quel montant elle est calculée.
Le mot peut sembler technique. Le contenu l’est beaucoup moins : « Une commande annulée ne compte pas parmi les trois commandes nécessaires » est une règle que vous pouvez écrire et vérifier sans programmer.
Gardez les décisions qui changent le résultat
Il n’est pas nécessaire de raconter chaque réunion. Conservez les règles importantes, les personnes concernées et les questions encore ouvertes. Pour une réservation, cela peut être le délai d’annulation ; pour un devis, la durée de validité.
Notez aussi pourquoi vous avez choisi une règle lorsque la raison sera utile plus tard. « Nous gardons une journée pour réorganiser le planning » explique mieux un délai qu’un simple nombre isolé.
Corrigez le document quand le besoin change
Si la remise passe de 10 % à 15 %, modifiez la règle écrite et indiquez sa date d’application. Précisez le sort des commandes déjà passées : le nouveau taux les concerne-t-il ?
Demandez ensuite une vérification sur une ancienne commande et une nouvelle. Le document, l’application et les essais doivent raconter la même chose. Un texte conservé mais devenu faux peut aussi créer des erreurs.
Préparez une reprise plus simple
Le code reste nécessaire pour faire fonctionner et modifier l’application. Les documents aident la personne qui le reprend à comprendre ce qu’elle doit préserver. L’un ne remplace pas l’autre.
Conservez également vos données, vos accès et les instructions utiles au fonctionnement. Vérifier que vous pouvez quitter un outil va plus loin que télécharger un dossier. Les documents seuls ne prouvent pas non plus les droits que vous détenez sur le logiciel.
Commencez avec une seule page
Écrivez trois règles qui comptent pour votre activité, puis un exemple correct pour chacune. Ajoutez une question non résolue et le nom de la personne qui peut y répondre.
Le guide du cahier des charges vous aide à compléter cette page. Dans Maestro, les documents préparés avec les agents servent de base à la discussion : relisez vos règles métier et demandez leur correction lorsqu’elles ont été mal comprises.
