Cela para\u00eet contre-intuitif mais laisser de c\u00f4t\u00e9 les sp\u00e9cificit\u00e9s de certains produits ou de formats propri\u00e9taires peut \u00eatre le plus difficile pour les r\u00e9dacteurs. Lorsqu\u2019elles adoptent DITA, les \u00e9quipes doivent apprendre \u00e0 travailler avec du contenu structur\u00e9 et modulaire. Cela signifie que les r\u00e9dacteurs techniques se concentrent sur le contenu lui-m\u00eame mais plus sur sa mise en forme. <\/p>\n\n\n\n
S\u2019assurer que la puce de cette liste est parfaite, que l\u2019indentation correspond au niveau du texte, changer la police du titre, etc. peut prendre jusqu\u2019\u00e0 50 % du temps d\u2019un concepteur d\u2019information, voire m\u00eame 80 % dans certains cas. Avec la r\u00e9daction structur\u00e9e, une partie importante du temps peut \u00eatre \u00e9conomis\u00e9e gr\u00e2ce \u00e0 l\u2019application automatique de la charte graphique sur les diff\u00e9rents formats et m\u00e9dia.<\/p>\n\n\n\n
Les b\u00e9n\u00e9fices sont doubles :<\/p>\n\n\n\n
- Du temps est d\u00e9gag\u00e9 pour d\u00e9veloppement du contenu<\/li>
- La charte graphique est contr\u00f4l\u00e9e par les feuilles de style, ind\u00e9pendamment du contenu<\/li><\/ul>\n\n\n\n
Laisser la mise en forme signifie aussi que la prochaine fois que l\u2019organisation change de logo ou que la charte graphique est mise \u00e0 jour, les \u00e9quipes de contenus auront simplement \u00e0 demander la mise \u00e0 jour des feuilles de style une seule fois \u2013 et la modification ne devra pas \u00eatre faite manuellement sur tous les documents.<\/p>\n\n\n\n
Adapter l’exp\u00e9rience de r\u00e9daction<\/span><\/h2>\n\n\n\n
Nous avons d\u00e9j\u00e0 parl\u00e9 de l\u2019utilisation de balises plut\u00f4t que de styles dans le premier article de cette s\u00e9rie. Toutefois, cela vaut la peine de souligner que la plupart des \u00e9diteurs modernes proposent une assistance aux r\u00e9dacteurs qui facilitent la transition vers DITA.<\/p>\n\n\n\n
Tout d\u2019abord, les outils proposent une vue am\u00e9lior\u00e9e des contenus dans l\u2019interface, ainsi l\u2019outil fournit des indications visuelles pour le balisage et un exemple de mise en forme, par exemple pour la publication web.<\/p>\n\n\n\n
Ensuite, dans l\u2019\u00e9diteur, les balises obligatoires et optionnelles peuvent \u00eatre implicitement propos\u00e9es aux r\u00e9dacteurs qui n\u2019ont alors besoin que de remplir les valeurs de ces champs. Par exemple, l\u2019\u00e9diteur peut vous proposer un champ de titre gris\u00e9 dans lequel le r\u00e9dacteur va entrer directement le titre. L\u2019\u00e9diteur peut \u00e9galement proposer tous les champs attendus dans un avertissement de s\u00e9curit\u00e9, sans que le r\u00e9dacteur doivent ajouter manuellement ceux-ci : type de danger, cons\u00e9quence, comment l\u2019\u00e9viter.<\/p>\n\n\n\n
Enfin, les r\u00e9dacteurs peuvent aussi utiliser des formulaires, lorsque le contenu est fourni dans des listes d\u00e9roulantes et adapt\u00e9 au mod\u00e8le d\u2019information utilis\u00e9 par l\u2019organisation.<\/p>\n\n\n\n
Abandonner les vieux outils<\/span><\/h2>\n\n\n\n
Si certaines personnes adopteront les nouveaux usages, les nouveaux outils et syst\u00e8mes sans regarder une seule fois en arri\u00e8re, changer d\u2019outils et de format peut s\u2019av\u00e9rer difficile pour d\u2019autres. Surtout pour ceux sont des experts des outils et syst\u00e8mes actuels.<\/p>\n\n\n\n
Il est donc crucial de mettre en place une strat\u00e9gie du changement r\u00e9elle aupr\u00e8s de ceux qui pensent, \u00e0 tort ou \u00e0 raison, avoir \u00e0 perdre avec l\u2019adoption de DITA dans l\u2019entreprise.<\/p>\n\n\n\n
Dissocier responsabilit\u00e9 et r\u00e9daction de contenu<\/span><\/h2>\n\n\n\n
Le centre CIDM a r\u00e9alis\u00e9 plusieurs pr\u00e9sentations et plusieurs enqu\u00eates pour mieux comprendre le sens de la propri\u00e9t\u00e9 d\u00e9velopp\u00e9 par les r\u00e9dacteurs techniques. Lorsque le contenu est modulaire et que des personnes diff\u00e9rentes participent \u00e0 la r\u00e9daction, les r\u00e9dacteurs doivent :<\/p>\n\n\n\n
- R\u00e9utiliser du contenu cr\u00e9\u00e9 par quelqu\u2019un d\u2019autre<\/li>
- Se retenir de modifier le contenu pour des raisons subjectives<\/li><\/ul>\n\n\n\n
Avec le contenu modulaire, le document final est bien la combinaison de plusieurs rubriques potentiellement r\u00e9dig\u00e9es par diff\u00e9rent membres de l\u2019\u00e9quipe. Les responsabilit\u00e9s peuvent \u00eatre donc s\u00e9par\u00e9es entre chaque partie et l\u2019ensemble. Le responsable du document n\u2019est donc pas n\u00e9cessairement le r\u00e9dacteur de tout le document. <\/p>\n\n\n\n
Tout organiser dans un cadre de travail r\u00e9p\u00e9table<\/span><\/h2>\n\n\n\n
La meilleure fa\u00e7on d\u2019organiser le travail et le contenu pour plusieurs r\u00e9dacteurs est bien de cr\u00e9er un cadre de travail pour ceux-ci. Par exemple :<\/p>\n\n\n\n
- Cr\u00e9er un guide de style DITA et v\u00e9rifier l\u2019application par des r\u00e8gles et des r\u00e9visions formelles<\/li>
- Utiliser des mod\u00e8les de rubriques et de cartes, ainsi que des exemples<\/li>
- Documenter le cycle de vie du contenu et la signification de chaque statut<\/li>
- V\u00e9rifier avec votre architecture d\u2019information, si l\u2019ajout de contraintes ou une sp\u00e9cialisation peut aider les r\u00e9dacteurs<\/li>
- Organiser les \u00e9quipes et les responsabilit\u00e9s : qui, quoi, quand<\/li><\/ul>\n\n\n\n
En fonction des outils, ces recommandations peuvent \u00eatre renforc\u00e9es. Chacun de ces points doit, bien s\u00fbr, \u00eatre compris et valid\u00e9 par l\u2019ensemble de l\u2019\u00e9quipe. <\/p>\n\n\n\n
Vous commencez tout juste avec DITA? Gardez un \u0153il sur ces sympt\u00f4mes<\/span><\/h3>\n\n\n\n
M\u00eame si la r\u00e9daction modulaire et structur\u00e9e rend cela difficile, il est toujours possible de cr\u00e9er de mauvais contenus avec DITA. \nL\u2019adoption du standard seul ne fera pas de grande diff\u00e9rence si vous ne tenez pas un certain nombre de sympt\u00f4mes \u00e0 l\u2019\u0153il. Les revues par les pairs sont efficaces, mais cette liste fournit un certain nombre de points probl\u00e9matiques :<\/p>\n\n\n\n
- Il y a tellement de segments conditionnels dans la rubrique que la lecture en devient impossible pour les r\u00e9dacteurs<\/li>
- Vous avez des blocs de texte larges et denses, sans inter-titres<\/li>
- Il y a tellement de liens entre rubriques que vous ne pouvez pas retrouver la premi\u00e8re rubrique source (sans aucun lien)<\/li>
- Il n\u2019y a ni balises en ligne, ni m\u00e9tadonn\u00e9es dans votre contenu<\/li>
- Toutes les rubriques sont des rubriques non-typ\u00e9es (pas de s\u00e9paration de base entre proc\u00e9dures, concepts et r\u00e9f\u00e9rences)<\/li>
- Incoh\u00e9rence dans le contenu. Indique souvent qu\u2019il manque un guide r\u00e9dactionnel, ou un guide de style, voire des mod\u00e8les <\/li><\/ul>\n\n\n\n
Pour aller plus loin<\/span><\/h3>\n\n\n\n
Il y a de nombreuses ressources en ligne et accessibles gratuitement dont les publications des comit\u00e9s et sous-comit\u00e9s OASIS et les sp\u00e9cifications DITA bien s\u00fbr. Vous pouvez aussi :<\/p>\n\n\n\n
- Lire un livre, par exemple le DITA Style guide or DITA Best Practices<\/li>
- Essayer un site d\u2019auto-apprentissage <\/li>
- Suivre une formation ou un atelier<\/li>
- Essayer des \u00e9chantillons de contenus <\/li><\/ul>\n\n\n\n
Cet article cl\u00f4t ainsi la s\u00e9rie d\u2019articles. Cette s\u00e9rie est bas\u00e9e sur la pr\u00e9sentation donn\u00e9e \u00e0 la conf\u00e9rence DITA Europe 2019 de Bruxelles \u201cDITA Surprise! Unpacking Authoring Practices\u201d.<\/p>\n\n\n\n
—
Retrouvez la premi\u00e8re partie<\/span> <\/a>et la deuxi\u00e8me partie<\/span><\/a> de cette s\u00e9rie de blogs.<\/p>\n\n\n\n
![\"\"](\"https:\/\/www.ixiasoft.com\/wp-content\/uploads\/2021\/02\/Nolwenn.png\")
<\/figure>\n\n\n\n