Nous travaillons sur un très gros projet. Après avoir créé les wireframes et rédigé les spécifications techniques, nous avons commencé à concevoir, découper et programmer.
Les spécifications techniques ont été approuvées par le client. Au cours du développement, de nombreux changements ont été apportés. La question est: Est-il raisonnable de mettre à jour les spécifications techniques chaque fois que des modifications sont apportées pendant le développement du projet?
Est-il raisonnable de mettre à jour les spécifications techniques chaque fois que des modifications sont apportées pendant le développement du projet?
Oui, ça vaut le temps de mettre à jour les spécifications.
Spécifications techniques ≠ documentation, mais souvent il n'y a pas de documentation du tout.
Donc, si des modifications sont apportées au cours d'un long projet, il n'y a aucune référence si les spécifications ne sont pas mises à jour. Après un certain temps, il y a beaucoup de devinettes et la seule façon de le savoir est de demander aux ingénieurs de rechercher le code (ce qui prend du temps et les rend moins productifs). Ou, si un système est déjà en ligne et fonctionne, cela nécessite un temps d'exécution intense d'un test sur ce système pour connaître le comportement.
Si les spécifications techniques et/ou la documentation sont à jour, il n'y a pas de devinettes et cela rend la vie de chacun plus facile. De plus, cela rend votre entreprise plus professionnelle car vous avez toujours une réponse rapide et correcte aux questions des clients.
Et dans un monde idéal, les spécifications techniques sont mises à jour avant le changement a été implémenté dans le code.
La réponse est oui. La documentation devrait toujours être mise à jour car il y a des changements du côté client. Cela vous permettra de produire une documentation mise à jour en cas de litige avec le client. Le développement de la fonctionnalité et ses tests seront également plus corrects et précis si et seulement si la documentation est toujours correcte.
Une spécification dépassée entraînera plus de confusion et de retard dans le processus de développement.