1 Vision classique contre vision nouvelle : méthodes, outils, processus La documentation

2 La documentation ? Cest quoi ? nDaprès vous, la documentation, cest du papier ? n…cest de laide en ligne ? n…cest de lassistance téléphonique (hot-line) ? nNoooooooooon !

3 La documentation, cest... des actions de l utilisateur Ulf L. Andersson (inventeur du concept « dhumaniciel »)

4 Notre monde est technologique nNos appareils sont de plus en plus nombreux, nDe plus en plus complexes, nEt reposent sur des composants logiciels.

5 Les actions de lutilisateur comportent des risques nPerte de temps, nPerte de données informatiques, nPerte de clients, sur des marchés très compétitifs, nPerte dargent.

6 La documentation, cest des actions de l utilisateur... nVotre client rachètera-t-il la version suivante de votre produit si vous lui avez fait perdre du temps et de largent ?

7 La vision classique de la rédaction technique Celle du gratte-papier laborieux et travaillant seul, ne permet pas de gérer ces risques et voici pourquoi...

8 La vision classique (version 1) nLe rédacteur collecte toutes les informations possibles nIl documente selon un plan standard et sans trop se poser de questions nIl produit des manuels volumineux... n...indigestes… n…chers à traduire… n…chers à mettre à jour... net surtout, INADAPTES aux besoins de l utilisateur

9 La vision classique (version 2) nLe rédacteur dispose de peu d informations nIl na pas accès au produit nLes ingénieurs nont pas de temps à lui consacrer nIl na aucune idée des besoins de lutilisateur nIl produit un document qui nest quune hypothèse de fonctionnement dun produit virtuel...

10 La vision classique, c est... …la « doc » quon nouvre plus parce quon ny trouve jamais rien !

11 Le « rédacteur technique » s appelle maintenant COMMUNICATEUR TECHNIQUE ou CONCEPTEUR-REDACTEUR parce que le marché prend en compte l utilisateur

12 La documentation fait partie du produit Alors il faut intégrer son cycle de développement dans celui du produit

13 Rôle du communicateur technique nDécrire les actions que lutilisateur veut effectuer nLui fournir un accès immédiat à ces informations nChoisir le support dinformation le mieux adapté nMais aussi : nAider à la conception de linterface utilisateur nAider à lamélioration des fonctionnalités du produit

14 Le cycle de la documentation nAnalyse produit nAnalyse des besoins de l utilisateur nAnalyse de linterface utilisateur nDéfinition de la structure du document nDéfinition de linterface utilisateur nRéalisation de la version 1 de la documentation nRelecture technique de la version 1 nTest de la version 1 (documentation et produit) nRéalisation de la version 2 nDiffusion de la documentation avec le produit nMise à jour

15 Les outils de gestion de projet nRéunion de lancement nRéunions de validation du plan et de linterface nRéunions de suivi hebdomadaires nRéunion de recette finale nSession de relecture technique de la version 1 nSession de test de la version 1

16 Les outils de synchronisation client/entreprise/produit nVisites en clientèle nContacts avec le SAV nContacts avec le marketing nContacts avec les commerciaux nManipulation du produit nCollaboration avec les ingénieurs

17 Pour être sûr que la documentation fonctionne... …faisons-la avant de développer le produit !