la documentation logicielle se transforme en gestion de stratégie de contenu collaborative et...

State of the art

Technology

Traitement de texte

SGMLInternet XML DIT

A

NormsMadiaTraining

Use cases

Julie Vivien, rédactrice techniqueTech’advantage

Responsable documentation utilisateurpour le compte de Total

Expérience

PérimètreDomaine géosciences multidisciplinaireDe multiples intervenants• 2 rédacteurs techniques - 80% du contenu• 4 intervenants du client• > 20 intervenants ponctuels spécialistes métier

• 2 autres équipes internes ou en sous-traitance

Expérience

PérimètrePlanification agileOutil développé par Tech’advantage• doc contextuelle connectée au produit• doc connexes, FAQ, procédures, référentiel

• livraison hebdomadaire

Méthodes

Expérience

Périmètre 2012 – 2014• priorité : quantité d’interfaces documentées

2014 - 2015• bases du logiciel couvertes• retours d’utilisateurs• la priorité évolue

• qualité plutôt que quantité• docs connexes pointus• méthodologie pour réduire le besoin en doc

MéthodesChantier

2015 – 2016• priorité : les nouveautés• par conséquent, accès plus facile aux experts

Expérience

Périmètre Pistes d’évolution exprimées• moteur de recherche

• 950 interfaces documentées• et 1680 documents connexes

• navigation thématique ou taxonomique• notre approche est centrée IU• les lecteurs doivent se situer dans

leurs process métier

MéthodesChantierEvolution

• participation du client• annotation, commentaires et contributions

en consultant la doc dans leur produit• stats analytiques pour gouverner la maintenance• ergonomie et terminologie IU• nouvelles formes ludiques, animation, vidéo,

une approche e-learning

Expérience

Christophe Aug,Beicip/Franlab, filiale IFPEN

Responsable ligne de produits et plateforme

Nicolas Philippe, rédacteur techniqueTECH’advantage

Accompagnement de la transformation

Expérience

PérimètreDomaine géosciences multidisciplinaireUne plate-forme logicielle• 7 produits

• une doc pour chacun• chacun a son style, sa forme• avec zones de recouvrement

Avec TECH’advantage – refonte de l’ensemble

Expérience

PérimètreIntroduction de la doc contextuelle

Effort important de transformation de l’existant• sortir le contextuel• créer les autres structures

Réorganisation éditoriale

Méthodes

Expérience

Périmètre La doc embarquée avec le produit est appréciéeEffort minimalisé de mise à jourRéduction considérable de volume

MéthodesRésultats

Expérience

La refonte n’est pas spontanéeRendre une équipe pluridisciplinaire cohérente• Guide de styles• Assistance dans l’édition• Relecture et retours

Aujourd’hui, ce sont les bases d’une stratégie éditoriale

www.doccontents.com

Evolution

PérimètreMéthodesRésultats

Ce dont nous disposons :• des technologies• des normes• un métier• du savoir-faire• de l’expérience

Constat

Etude

Thibaut BaronCabinet Gtec

Dirigeant & Consultant Senior

Etude

PérimètreConcernant l’implémentation de la documentation utilisateur

Auprès d’éditeurs de logiciels• startups / ETI• centrés marché français / international• business model traditionnel / SaaS• solutions installées / Web• logiciels propriétaires / open source

Etude

PérimètreLa Doc : un boulet pour les éditeurs de logiciels• ils restent figés dans un modèle de conception

et sont confrontés à de fortes problématiques d’obsolescence

Une Doc figée dans une forme et un process des années 1990 • création et process de mises à jour

fortement décorrélés du développement logiciel même en mode agile

• en général, ils réalisent la doc “à côté” de leur solution logicielle, peu interactive et systématiquement obsolète

Conclusions

Etude

PérimètreUne incapacité à réinventer le modèle• ils se contentent du service minimum • certains vont même jusqu’à assumer

l’absence de doc pour leurs solutions

• même lorsque l’innovation logicielle est au cœur de leurs préoccupations

• ils peinent à réinventer un nouveau modèle de doc performant, intégré et réellement consulté par leurs utilisateurs

La doc est vécue comme un centre de coûts, et non comme un levier de valeur ajoutée

Conclusions

Editeurs de logicielsQuelle motivation ?

• une vraie valeur ajoutée• la satisfaction de leurs utilisateurs• image de marque

Editeurs de logicielsQue pouvons-nous leur

proposer ?• prendre la main• mieux comprendre ce que nous apportons• insérer la production de la doc dans leurs process

Editeurs de logicielsQue pouvons nous leur

proposer ?• devenir décisionnaire - en définissant une stratégie de contenu• bâtir le contenu de manière agile - du bas vers le haut• travail collaboratif

Stratégie de contenu

Fixe les objectifsDéfinit l’audienceDétermine les canauxDécide du contenuOrganise les sourcesOrganise la validation

Construction incrémentaleDu bas vers le haut

• documenter l’IU• ajouter les sujets connexes• commenter, contribuer• valider• publier

Construction collaborativeQui collabore et comment ?

• développeurs et rédacteurs• le support• les experts

Rédacteurs

- évolution de leur rôle

Au-delà de la rédaction• architecte - structure de contenu• garant - cohérence éditoriale• animateur - cycle production

Stand B29