Rétrospective de DITAWORLD 2022
c-rex.net à la DITAWORLD 2022
Trois jours de conférences sur le thème " Intelligent Content for an intelligent world
". Tel était le slogan choisi cette année par Adobe pour DITAWORLD 2022.
Selon Adobe, plus de 6000 participants du monde entier ont assisté à la conférence en ligne du 10 au 12 mai 2022.
Le programme proposait des conférences, des keynotes et des rapports pratiques sur une grande variété de sujets. Il a notamment été question de DITA, d'édition structurée, de RoboHelp, de Captivate, de localisation, de microcontenu, de documentation API et de bien d'autres choses encore.
Chez c-rex, nous étions présents pour la première fois en tant que sponsor Platinum et avons participé cette année à deux sessions.
Building Content Bridges. Why Content Needs to Flow Like Water.
Dans son discours d'ouverture, Markus Wiedenmaier explique pourquoi le contenu doit couler comme de l'eau, pourquoi deux approches sont nécessaires lorsqu'il s'agit de créer du contenu et que nous devons penser en termes d'interface.
Dans la section Construire des ponts de contenu. Pourquoi le contenu doit couler comme de l'eau. il y a un bref résumé.
Un enregistrement de la keynote est disponible sur YouTube.
Decouple development and documentation processes. API-Documentation - with OpenApi/Swagger, DITA, and AEM
Dans sa deuxième présentation, Markus s'intéresse aux processus de développement et de documentation. Le développement de logiciels et la rédaction technique ne sont plus des silos. Au contraire, ils grandissent de plus en plus ensemble. Les personnes qui développent des logiciels rédigent également la documentation utilisateur. Ou bien l'équipe de rédaction technique fait partie de l'équipe Scrum et accompagne le développement. Mais est-ce une bonne chose que la documentation soit écrite par l'équipe de développement ?
La réponse de Markus et sa suggestion sur la manière de traiter cette problématique de manière judicieuse se trouvent dans la section Dissocier les processus de développement et de documentation. Documentation API - avec OpenApi/Swagger, DITA et AEM et dans l'enregistrement de la conférence sur YouTube.
Construire des ponts et relier ainsi les silos de contenu. Pourquoi le contenu doit couler comme de l'eau.
Résumé du contenu de la conférence.enregistrement de la conférence sur YouTube
Si les entreprises passent à côté de la transformation numérique, elles passent aussi à côté de la disruption. Mais comment une organisation parvient-elle à se transformer lorsqu'elle se trouve dans des structures d'entreprise en silos ? En particulier dans le domaine de la documentation technique - mais aussi au-delà ? La rupture purement technique des silos ne suffit pas. Peut-être même qu'à certains endroits, casser ces silos est contre-productif.
Nous avons plutôt besoin de deux "systèmes d'exploitation de contenu" dans le cadre de notre stratégie de contenu :
Nous en avons besoin d'un pour nos données internes et nos processus rédactionnels.
Il doit être structuré, stable, tolérant aux erreurs et transporter automatiquement les informations.
Et nous en avons besoin d'un pour intégrer notre monde extérieur de plus en plus dynamique.
Ce système doit évoluer de manière agile et s'adapter de manière flexible aux exigences de nos clients, des utilisateurs et du marché.
Nous devons penser en termes d'interfaces : D'un point de vue technique et organisationnel.
Les informations sur les entreprises et les produits doivent - comme l'eau - circuler à l'intérieur et à l'extérieur de l'entreprise vers tous ceux qui en ont besoin, vers les personnes et surtout vers les machines.
Découplez les processus de développement et de documentation. Documentation API avec OpenApi/Swagger, DITA et AEM
Résumé du contenu de la conférence.enregistrement de la conférence sur YouTube
Le développement de logiciels et la rédaction technique ne sont plus des silos. Ils ont fusionné et la documentation utilisateur est souvent prise en charge par le développement logiciel.
Mais est-ce une bonne chose que les personnes qui développent les logiciels écrivent également la documentation ? Notre réponse est un non catégorique. Enfin, il faut des connaissances spécialisées dans les deux disciplines. Et devinez qui gagne lorsque la date de remise approche et que le code du logiciel et la documentation du logiciel sont écrits par la même personne. Est-ce la version du logiciel ou la documentation qui gagne ?
La meilleure option est d'avoir les deux : les personnes qui développent des logiciels et les personnes qui décrivent des logiciels et en assurent la rédaction technique. Notre tâche consiste à relier intelligemment les deux domaines de manière à ce qu'ils puissent travailler de manière découplée et que l'échange d'informations se fasse le plus automatiquement possible. Si nous gardons également à l'esprit le groupe cible, nous avons une approche pérenne de la création de documentation logicielle.
L'exposé montrera, à l'exemple de la documentation API REST, comment utiliser la spécification OpenAPI (anciennement spécification Swagger) et DITA et comment les intégrer dans Adobe Experience Manager.
L'objectif est de découpler le processus de documentation, de réduire considérablement le besoin de communication entre les deux domaines et de créer un concept pour une documentation API conviviale.
Nous vous renvoyons ici à notre article de blog Documenter avec souplesse avec DITA, dans lequel nous décrivons la puissance des mécanismes de réutilisation de DITA.