Étiquette : documentation technique

Sortie de Dokiel 4.1

Logo Dokiel

DokielGuide, rebaptisé Dokiel, est disponible sur la version 4.1 de Scenari.

De DokielGuide à Dokiel…

En plus du Guide, vous avez désormais à disposition une extension (intégrée directement dans le pack Dokiel) qui permet de scénariser une Documentation de référence.

Autant le Guide peut être vu comme un manuel à lire de bout en bout et dont le scénario didactique permet d’acquérir, pas à pas, des compétences d’utilisation d’un logiciel, autant la Documentation de référence favorise une « approche par problèmes« .

Dans cette approche, l’utilisateur du logiciel consulte la documentation avec une question précise et peut utiliser le mode d’accès le plus direct possible, celui qui lui convient le mieux, pour trouver la réponse. C’est pour cela que les points d’entrées ont été démultipliés :

  • moteur de recherche,
  • arborescence : plusieurs arborescences thématiques peuvent coexister (par profil, FAQ, par modules applicatifs…) en réutilisant massivement les items existants,
  • index : Glossaire de Concepts, liste des Procédures.

Ce scenario et sa publication sont disponibles pour la première fois, ils vont donc nécessiter des adaptations en fonction des usages : n’hésitez pas à partager vos remarques et difficultés sur le forum.

Quoi d’autre ?

  • Trois nouveaux types d’items :
    • un Listing informatique, permettant d’insérer une portion de code informatique, bénéficiant d’une colorisation syntaxique dans l’éditeur et dans les publications,
    • un Arbre synoptique, fondé sur les principes des cartes heuristiques,
    • une vidéo au format MP4 – pour remplacer progressivement le format FLV ;
  • La possibilité de relire et de commenter le site web du Guide, depuis un navigateur web (sans installer un client Scenari) ;
  • Des publications web du Guide en Html5-Aria, dont l’accessibilité s’améliore encore un peu plus.

Les anciens items de publication (au format papier Open Document et le site web Or) sont toujours disponibles dans l’extension Legacy, sur le site des Addons. Ces générations ne publient pas les nouveaux items de Dokiel.

Version anglaise

Dokiel est également disponible en langue anglaise (éditeur et générateur).

Si vous n’avez besoin que des générateurs localisés (sans modifier la langue de l’éditeur), c’est tout à fait possible en assemblant les différentes composantes dans SCENARIbuilder.

Personnalisez et adaptez Dokiel…

… avec les composantes formation

Les composantes formation (Formation sur site et Tutoriel) sont mises à jour sur Scenari 4.1 et Dokiel peut être personnalisé en les ajoutant via SCENARIbuilder.

… intégrez votre charte graphique

En utilisant SCENARIStyler, personnalisez la charte graphique de votre Dokiel.

Juste deux exemples :

Charte graphique Dokiel Université de Strasbourg

Charte graphique Dokiel Université de Strasbourg

Charte graphique Dokiel de PMB Services

 

Choisissez d’être accompagnés…

Pour vous accompagner dans la migration de votre chaîne éditoriale Dokiel, sa personnalisation, son déploiement, consultez la page des services que nous vous proposons et contactez-nous.

A propos de Dokiel…

Dokiel est une chaîne éditoriale libre Scenari, dédiée à la documentation et à la formation logicielles.

Pour télécharger, retrouver la documentation, l’offre de services…

Sortie de Dokiel 4.0

Dokiel Guide 4.0, compatible avec la version 4.0 de Scenari, est disponible !

Citons notamment les évolutions suivantes :

  • Un nouvel habillage graphique, plus sobre et élégant
  • Une publication papier directement en PDF : terminé les problèmes d’affichage des images, les pages blanches… lors de la création de documents volumineux
  • Des titres riches, permettant de mettre une icône dans le titre
  • Des filtres autorisant la création de deux versions du même Guide
  • Une nouvelle publication dynamique des items Écrans qui rendra encore plus attractives et explicites les descriptions des écrans de vos applications.

Dokiel Guide 4.0 est à télécharger ici.

La documentation complète des fonctionnalités de Dokiel Guide a été repensée.

Vous retrouverez les services que nous vous proposons autour de cette chaîne éditoriale sur le site dokiel.fr :

  • Accompagnement de votre migration depuis la version précédente de Dokiel
  • Adaptation de Dokiel Guide à vos besoins (charte graphique, structure documentaire, modèle de collaboration…)
  • Hébergement de vos contenus en mode client-serveur
  • Formation des rédacteurs et assistance
  • Configuration d’une chaîne complète, comprenant les composantes « documentation », « formation » et « tutoriel« .

A propos de Dokiel Guide…

Dokiel Guide est une chaîne éditoriale de conception de documentation logicielle, technique et fonctionnelle, construite à partir de la librairie Dokiel, dédiée au logiciel.

Pour accéder aux ressources communautaires et à l’offre de services

Copyright © 2022 Blog de Kelis

Thème par Anders NorenHaut ↑