Feriez-vous confiance à un constructeur pour commencer à construire votre maison sans aucun plan ? Il en va de même pour les projets de sites Web ! Sauter les préparatifs comporte des risques.
Découvrez comment rédiger des spécifications fonctionnelles de site Web efficaces qui mettent tous les membres de l’équipe sur la même longueur d’onde avant de commencer à développer quoi que ce soit.
L’une des principales responsabilités de l’analyste fonctionnel est de fournir une description claire et détaillée des différentes parties fonctionnelles d’un site Web et de leur comportement requis.
Ces descriptions de ce que fera le site Web appelées spécifications fonctionnelles ou cahier des charges. Il ne s’agit pas seulement des éléments visibles pour les visiteurs du site, comme les galeries d’images, les vidéos, les formulaires de contact, mais aussi des fonctionnalités utilisées par les gestionnaires de contenu dans l’interface de création du système de gestion de contenu Web (WCMS).
Des exemples de cette dernière sont les modèles utilisés pour créer différents types de pages Web (par exemple, événements, nouvelles, annonces d’emploi) et gérer les options de personnalisation ou de style de chacun des composants de la page.
Les spécifications fonctionnelles sont également des outils importants utilisés par les différentes équipes web :
Le client peut les utiliser pour vérifier si la fonctionnalité qui sera développée correspond à ses besoins et pour suggérer des optimisations avant le début du processus de mise en œuvre. Les spécifications fonctionnelles sont également utilisées par le client pour définir les critères d’acceptation du projet avec l’analyste.
Le chef de projet sera en mesure d’affecter des ressources aux tâches et de tracer un calendrier raisonnablement précis pour le projet.
Le responsable technique utilise les spécifications fonctionnelles comme point de départ pour définir les spécifications techniques du développement.
Les développeurs front les traduisent en fichiers HTML, CSS et JavaScript nécessaires pour mettre en œuvre le comportement frontal envisagé.
Les développeurs du CMS combinent les spécifications fonctionnelles et techniques comme entrées directes pour commencer le travail de développement.
Les testeurs s’en servent comme base pour établir des directives sur ce qu’il faut tester pour chaque fonctionnalité, ainsi que pour documenter et créer des scénarios de test détaillés.
Pour l’équipe d’assistance, il s’agit d’une référence de base pour obtenir des informations rapides sur les fonctionnalités lors de la résolution d’incidents ou de la maintenance et de l’optimisation continues.
Un bon cahier des charges doit répondre aux besoins des différentes équipes impliquées dans le projet de site Web. Mais que devez-vous prendre en compte pour couvrir autant d’aspects de la conception, des fonctionnalités, du développement et de l’expérience utilisateur ? Les 10 conseils suivants vous aideront à démarrer.
- Favorisez la collaboration
Il est essentiel de comprendre que la création d’un cahier des charges n’est pas une tâche individuelle. Elle est le résultat d’une collaboration entre le client, l’analyste fonctionnel, l’UX, le design et les équipes techniques. Par conséquent, les spécifications sont de préférence créées dans un environnement collaboratif (par exemple, à l’aide d’un outil comme Confluence). Cela permet à tous les membres de l’équipe de travailler ensemble de manière simple, même s’ils sont géographiquement éloignés. L’analyste fonctionnel peut être considéré comme le maître des spécifications, qui s’assure que toutes les entrées sont documentées de manière cohérente - Rendez-le identifiable de manière unique
Les spécifications fonctionnelles doivent être identifiables. Pour ce faire, il faut définir un nom clair et unique pour la fonctionnalité décrite. Cela semble être une étape triviale, mais l’expérience montre qu’elle est importante. Ce nom est important car il sera utilisé tout au long du cycle de vie du projet Web. Il sera utilisé dans les conversations avec toutes les parties prenantes, dans le code, la documentation technique, la documentation utilisateur et la formation. Réfléchissez donc à deux fois avant de définir ce nom. Fournissez également un ID numérique unique, à côté du titre plus descriptif. - Structurez-le
Les spécifications doivent être structurées pour faciliter leur utilisation. Au cours des conversations, il doit être facile de les consulter et de retrouver rapidement les informations requises. Des choses apparemment simples peuvent vous aider à y parvenir :
- Créez un modèle pour vous assurer que tous les documents de spécification fonctionnelle des composants fonctionnels sont structurés de la même manière.
- Utilisez un tableau au lieu d’un texte courant pour détailler les spécifications individuelles de chaque composant.
- Standardisez et structurez la formulation des spécifications fonctionnelles individuelles de la même manière, par exemple en utilisant un format tel que « En tant que visiteur, je devrais être capable de… ».
- Rendez-le visuel
Les gens préfèrent regarder plutôt que lire. Ils ont également tendance à mieux comprendre les choses lorsqu’ils les voient. L’ajout d’éléments visuels à votre document de spécification aidera les différentes équipes concernées à comprendre plus rapidement la fonctionnalité décrite. Pour ce faire, vous pouvez ajouter des images filaires, des organigrammes, des prototypes, des captures d’écran, etc.
- Intégrez le projet
Chaque fois que vous le pouvez, ajoutez des références claires à des ressources supplémentaires pertinentes au sein du projet. Lorsque les différentes équipes commencent à utiliser les documents de spécifications, il doit leur être facile de localiser les sources d’information connexes, telles que les fichiers de conception, les guides de style de codage, les spécifications de conception, les prototypes ou même les spécifications fonctionnelles connexes pour, par exemple, les modèles sur lesquels un composant fonctionnel est utilisé. - Rendez-le lisible
Les documents de spécifications fonctionnelles sont, comme nous l’avons déjà mentionné, utilisés par de nombreux rôles différents. Ils sont utilisés comme un instrument pour discuter et informer toutes les équipes sur toutes les caractéristiques, les interactions et chaque détail du comportement fonctionnel qui doit être inclus. Par conséquent, ils doivent être rédigés d’une manière non technique qui soit clairement compréhensible par toutes les parties prenantes, qu’elles aient ou non des connaissances techniques. - Rendez-le extensible
Une spécification initiale est créée pour chaque composant fonctionnel au début d’un projet Web. Après la mise en ligne d’un site Web, il est naturel que des optimisations supplémentaires soient apportées à plusieurs de ces composants et que de nouvelles fonctionnalités soient ajoutées. Cela signifie que le comportement fonctionnel peut être révisé. Il est important que cette extensibilité soit prise en compte dès le début, et que la configuration des spécifications des composants permette des extensions faciles à l’avenir. - Soyez précis
Les spécifications doivent être claires et précises. Dans un monde idéal, les développeurs ne devraient pas avoir à deviner ou à interpréter les descriptions fonctionnelles. Pour ce faire, ils doivent utiliser un langage clair, fournir des exemples si nécessaire et obtenir des réponses à toutes leurs questions sur ce qui doit être réalisé, comment et pourquoi. - Assurez la traçabilité
Au cours des discussions fonctionnelles entre les membres de l’équipe web et le client, de nombreuses décisions sont prises. Veillez à garder une trace de toutes les décisions relatives à la fonctionnalité et à ce qu’elles soient reflétées dans le document final des spécifications fonctionnelles approuvé par le client. Bien que de nouvelles fonctionnalités puissent toujours être introduites au milieu du projet, cela sera utile pour éviter des discussions à l’avenir. - Rendez-le digeste
Lors de la création de spécifications écrites, il est important d’éviter une surcharge d’informations. Une façon de le faire est d’identifier les différentes parties fonctionnelles d’un site Web et de créer des spécifications distinctes pour chacune d’entre elles. C’est également une bonne idée d’organiser les spécifications au niveau des modèles de page et des composants fonctionnels individuels utilisés sur ces modèles. D’une part, cela permet de concentrer les informations pour le lecteur, et d’autre part, cela correspond à la façon dont les tâches sont généralement organisées dans les histoires Agile, ce qui facilite l’intégration avec un logiciel de suivi de projet comme JIRA.
Conclusion
Il semble évident que le document de spécification fonctionnelle est essentiel pour garantir que les équipes de conception et de développement travaillant sur le projet sont sur la même longueur d’onde que le client et, en fin de compte, pour garantir que tout le monde sera satisfait du produit fini.
Veillez à ce que votre équipe Web compte des analystes fonctionnels expérimentés qui possèdent une expertise approfondie de tous les aspects de la conception, de la fonctionnalité, du développement et de l’expérience utilisateur du site Web. Un cahier des charges efficace fournit une feuille de route et des objectifs clairs à l’équipe web, et permet d’éviter les écarts inutiles par rapport au plan, non seulement en termes de temps, mais aussi en termes de coûts.
