Pourquoi et comment nous créons des historiques de conception

Cet article a été écrit par Paul Hayes, concepteur d'interactions au ministère de l'Éducation. Une version de ce billet de blog a été initialement publiée sur le blog de DfE Digital sur GOV.UK.

Les services que nous construisons au sein du gouvernement sont modifiés et améliorés (ou réitérés) au fil du temps. Ils sont construits et reconstruits. Les membres de l'équipe vont et viennent. Des questions sur la raison pour laquelle un service est la façon dont il est devenu plus difficile de répondre. Le contexte se perd, la recherche disparaît et la raison d'être de la conception est de moins en moins claire.

• Tu veux écrire pour nous? Jetez un œil au guide d' Apolitical pour les contributeurs

Garder un «historique de conception» permet d'expliquer facilement pourquoi un service est tel qu'il est. Nous expliquons ici pourquoi et comment nous avons rédigé des historiques de conception de services pour certains services de DfE.

Qu'est-ce qu'une histoire du design

Une histoire du design est comme un blog. Il contient des publications (ou mises à jour) décrivant le développement de nouvelles fonctionnalités, des itérations de fonctionnalités existantes ou des résultats de recherche d'utilisateurs. Il contiendra tout ce qui peut être utile de revenir plus tard.

Notre histoire de conception est un enregistrement public de nos conceptions et elle raconte l'histoire de ce que nous avons conçu et pourquoi

Au sein de l'équipe `` Devenir enseignant '', nous avons utilisé un historique du design pour documenter l'évolution des services `` Trouver une formation d'enseignant de troisième cycle '' et `` Demander une formation d'enseignant '' depuis leur lancement en mai 2018.

Notre histoire de conception est un enregistrement public de nos conceptions et elle raconte l'histoire de ce que nous avons conçu et pourquoi.

Comment notre histoire du design a commencé

En 2018, nous avions du mal à documenter nos conceptions.

Nous avons commencé par essayer de télécharger des captures d'écran ou de créer de nouvelles versions de nos prototypes (conceptions préliminaires), pour conserver les anciennes conceptions sur différentes URL. Mais les conceptions ont changé trop souvent pour que nous puissions continuer à le faire.

Le prototype pourrait nous montrer ce que nous avons conçu, mais pas pourquoi. Si les conceptions devaient être documentées, cela devait être rapide et facile et non pas une corvée.

Nous avons utilisé le kit prototype GOV.UK pour créer la première histoire du design et l'avons hébergé sur une plate-forme appelée Heroku . Le kit a facilité la création de pages, et nous avons commencé par créer des articles pour chaque fonctionnalité, en affichant une liste de captures d'écran ainsi que des descriptions de ce qui avait changé et pourquoi.

Il y avait également une URL publique pour chaque design. L'équipe pourrait l'utiliser pour faire référence dans les user stories ou lors de l'écriture de code.

Lorsqu'il était clair que ces publications étaient utiles, nous avons facilité leur création. Nous avons automatisé le processus en prenant des captures d'écran, en enregistrant les images au bon endroit et en générant une page avec tout le HTML nécessaire.

Maintenant, nous pourrions nous concentrer sur l'écriture de la conception plutôt que d'avoir à enregistrer ce que nous concevons.

En utilisant le système de conception GOV.UK pour nos articles, nous avions une plate-forme facile à utiliser, lisible et familière pour notre histoire de conception. C'était ressenti dès le début.

Nous voulons que plus d'équipes conservent une histoire de conception ouverte et publique. Nous avons pris notre histoire de conception et en avons fait un outil que d'autres équipes peuvent utiliser

Pendant que nous recherchions nos conceptions, nous avons enregistré nos résultats avec des captures d'écran pertinentes. Nous avons commencé à créer des liens vers des recherches et des clips vidéo sur Lookback (un outil de recherche d'utilisateurs à distance) - créant un lien direct entre une conception et la source d'une nouvelle découverte.

Au fil du temps, nous pourrions commencer à montrer les anciens et les nouveaux modèles, et des changements spécifiques aux légendes. Nous enregistrions et rendions nos décisions de conception claires au fur et à mesure. Les entrées de l'histoire du design ont commencé à raconter notre histoire.

Enregistrer les choses qui comptent

Au fur et à mesure que l'histoire grandissait, nous avons enregistré davantage, par exemple des instantanés du service à des étapes importantes, comme lors du lancement d'une version bêta publique ou de notre premier outil de publication.

Parfois, le raisonnement derrière une fonctionnalité de conception particulière peut se perdre ou se cacher dans le code. Ou la justification peut être évidente dans certains parcours utilisateurs uniquement.

Nous nous sommes assurés que maintenant, lorsqu'il y a des raisons et des scénarios qui influencent une conception, nous les capturons dans l'historique de la conception. C'est l'endroit naturel pour les décrire, et il est plus facile pour les développeurs de créer ces fonctionnalités.

Par exemple, dans le service «Candidature à la formation des enseignants», nous demandons aux candidats leur nationalité.

Cela explique:

• comment les candidats peuvent enregistrer plusieurs nationalités
• que se passe-t-il lorsque 2 ou 3 sont enregistrés
• comment la conception fonctionne sans JavaScript
• comment nous l'avons rendu accessible

Parfois, nous devions imprimer des dessins à montrer dans la recherche, à mettre sur le mur ou pour des séances de groupe. Une publication montre généralement des captures d'écran pour une fonctionnalité complète ou le parcours de l'utilisateur, donc imprimer ces captures d'écran serait idéal. Nous avons ajouté des styles d'impression afin que chaque article puisse être imprimé avec une capture d'écran (et un titre) sur une page

Nous avons aussi:

• documenté les informations que nous demandons aux utilisateurs de nous fournir
• les e-mails que nous envoyons aux utilisateurs
• les processus suivis par notre équipe

Faciliter les contributions

Lorsque l'équipe de conception s'est agrandie, davantage de personnes ont dû contribuer.

Pour rendre cela plus facile, nous sommes passés du kit prototype à l'utilisation d'un outil de publication appelé Eleventy. Cela a permis aux concepteurs, aux développeurs, aux concepteurs de contenu et à ceux qui mènent des recherches sur les utilisateurs de tous contribuer à l'histoire du design.

Avec Eleventy, nous avons ajouté de nouvelles fonctionnalités pour rendre l'historique de conception plus facile à utiliser, comme la fonction de recherche, qui est essentielle compte tenu du nouveau volume de publications. Il y a aussi:

• pagination (séquence de pages connectées et ayant un contenu similaire)
• tri des articles par date ou par catégorie
• Liens connexes

En juillet 2020, nous documentons 5 services avec plus de 200 publications.

Créez votre propre historique de conception

Nous voulons que plus d'équipes conservent une histoire de conception ouverte et publique.

Lorsque nous concevons quelque chose de nouveau et que nous cherchons à voir comment d'autres équipes de service ont résolu ce problème, nous voulons en savoir plus sur leurs conceptions, les évaluer et les développer.

Nous avons trouvé la nôtre incroyablement utile et nous voulons maintenant voir d'autres équipes de service en bénéficier également. Nous avons pris notre historique de conception et en avons fait un outil que d'autres équipes peuvent utiliser - un endroit où toutes les fonctionnalités, scripts et guides de démarrage sont conservés.

Nous continuerons d'ajouter les fonctionnalités dont nous avons besoin - comme des moyens de documenter les besoins des utilisateurs et des idées de conception, l'intégration avec d'autres outils comme Trello, etc. En ouvrant cet outil pour partager avec d'autres équipes et personnes extérieures à notre organisation, nous espérons voir de nouveaux développements et idées. - Paul Hayes

(Crédit photo: