Je pense qu'avec toute documentation, l'approche agile est bonne. Maintenant, il y a certaines idées fausses selon lesquelles agile signifie "pas de documentation ou d'analyse du tout", mais ce n'est pas le cas. Les choses que j'ai lues sur Agile disent: «utilisez ce qui fonctionne». Je suppose que cela signifie que le document doit être long et détaillé à la hauteur de la tâche.
Les modèles peuvent être utiles en tant que liste de contrôle, mais je n'exigerais pas que chaque section soit remplie pour les changements mineurs ou à faible risque. Pour un changement d'une ligne, vous n'avez peut-être pas du tout besoin d'un document. Je n'ai jamais utilisé de modèle pour un document d'analyse d'impact, mais je traite régulièrement des exigences métier ou des spécifications techniques. Un modèle peut être trop restrictif; une bonne ligne directrice est plutôt de considérer qui sera le public. S'il s'agit de gestionnaires qui ne sont pas techniques, concentrez-vous sur la justification commerciale du changement. Si c'est pour les techniciens, fournissez un peu de fond pour qu'une nouvelle personne dans l'équipe ne soit pas perdue et donnez-leur suffisamment pour démarrer s'ils doivent soutenir le changement. De plus, si vous voulez quelque chose d'encore plus léger et sans friction, n'utilisez pas du tout de document, mettez-le sur un wiki.
Informations à inclure:
- Brève description du problème
- Expliquer ou montrer un exemple de la façon dont un défaut provoque une défaillance et / ou une inefficacité
- Inclure une estimation de la complexité
- Inclure une estimation du coût et du temps de réparation
C'est un minimum décent. L'autre article a mis en évidence des trucs CMMi assez lourds d'IBM; c'est génial si vous avez le temps et les ressources pour cela (et quand vous construisez des systèmes pour la NASA où la vie humaine est en jeu, alors les gens devraient être sérieux à ce sujet) mais pour les petites équipes, vous n'avez probablement pas besoin d'être aussi lourd . Soyez prudent avec l'estimation, comme toujours. Les gestionnaires sont enclins à supposer qu'une estimation est la réalité.
Notez qu'il y a des dangers dans l'approche agile. Certains développeurs pensent que cela signifie, "aucun document nécessaire, commencez simplement à pirater" (ce qui pourrait être OK dans certaines situations). En outre, d'autres prendront la latitude compte tenu de la tâche et rédigeront simplement des documents vraiment merdiques qui n'aident pas vraiment (pas nécessairement OK dans la plupart des situations). Le problème tient en partie au fait que bien écrire exige un certain effort, des compétences et du temps; la plupart d'entre nous sont à court d'au moins deux de ces choses;)
J'ai toujours été très attaché à la documentation, car cela prouve que vous avez au moins suffisamment réfléchi pour être admissible à un plan. Mais dans ma vieillesse, j'ai également compris que trop de documentation peut elle-même devenir un problème de maintenance, et que pas assez de gens se soucient suffisamment de maintenir la documentation à jour.