La Documentation dans le Cycle de développement Le cycle de développement • La rédaction de la documentation s’inscrit dans un cycle de développement – Du produit – De la documentation elle-même Lucy Veisblat Cycle de développement du produit • Existe pour tout développement de produit – de façon plus ou moins formelle • Comporte un certain nombre de phases – Nombre variable selon les entreprises et/ou le type de produit – Dénomination des phases variable selon les entreprises • Assure la formalisation du passage d’une phase à l’autre Lucy Veisblat Les phases du cycle de développement • Phase 0 – Stratégie • Phase 1 – Planification et Conception préliminaire (design) • Phase 2 – Implémentation (ou mise en œuvre) • Phase 3 – Validation • Phase 4 – Production, Vente, Maintenance • Phase 5 – Retrait Lucy Veisblat Phase 0 – Stratégie • Etude de faisabilité d’un produit • Plans préliminaires de : – Développement – Production – Maintenance – Documentation – Marketing – Formation Lucy Veisblat Phase 1 – Planification • Décision de commercialisation d’un produit • Réponse aux questions Quoi, Comment, Quand, Combien ? • Spécifications fonctionnelles du produit • Plans finalisés de : – – – – – – Développement Production Maintenance Documentation Marketing Formation Lucy Veisblat Phase 2 - Implémentation • • • • Phase la plus longue Développement du produit Développement de la documentation En fin de phase, mise à jour de tous les plans, y compris le plan de documentation Lucy Veisblat Phase 3 – Validation • Phase de tests • Documentation est testée contre le produit • Version finale de la documenation • Fabrication des BAT Lucy Veisblat Phase 4 – Production, Vente, Maintenance • Fin des phases de conception et de développement • Produit sort des mains des concepteurs et développeurs • Fabrication en série • Cycle de mise sur le marché – Intervention du marketing et des ventes Lucy Veisblat Phase 5 – Retrait du Produit • Fin de cycle de vie du produit • Remplacement par produit suivant • Consolidation de toutes les informations sur le produit pour la prochaine version – Rapport post-mortem Lucy Veisblat Cycle de développement de la documentation • Implication du rédacteur technique en Phase 0 (situation idéale) • Implication du rédacteur technique en fin Phase 1 pour rédaction du plan de documentation (situation la plus courante) Lucy Veisblat La documentation dans le cycle de développement du produit Phase Recherche d’informations 0 Compréhension (marché et auditoire) Phase Planification 1 Définition de la structure documentaire Phase Rédaction / Révision 2 Processus itératif Phase Validation de la documentation Lucy Veisblat 3 Conclusion • « There’s more to technical writing that writing » • Implication du rédacteur technique est nécessaire tout au long du développement du produit. Lucy Veisblat