URL: https://linuxfr.org/users/strash/journaux/gestion-de-documentation-6e99aa61-23eb-486b-b989-8a34ca0778f6 Title: Gestion de documentation Authors: Strash Date: 2019年01月21日T18:14:47+01:00 License: CC By-SA Tags: dita, docbook, documentation, alfresco, weasyprint, etherpad et tracim Score: 31 Bonjour à tous, Je suis devant une problématique où il me manque des outils informatique pour accomplir une tache qui me semble de l'ordre du faisable techniquement avec des briques existante. Mais avant de redécouvrir la roue, j'aimerai votre avis et retours d'expérience. Le contexte ----------- L'entreprise dans laquelle je suis conçois et vends des équipements industriels. Chaque équipement est unique mais repose sur des bases similaires (des plateformes identiques auxquelles on ajoute des options standardisées ainsi que des options spécifiques développées pour le client). Avec chacun de ces équipements, on fourni une documentation extensive du matériel (plans, schémas électriques, hydraulique et pneumatiques, équipements et instruments fournis, description du soft de l'automate, manuel d'utilisation, manuel de maintenance, manuel d'installation...), qui représente plusieurs centaines de pages. Ces documents sont vérifiés et signés en interne et par le client avant et après la fabrication et font souvent l'objet de modifications (suivi par des versions, elles vérifiées et signées). L'état actuel ------------- Mis à part les plans et schémas qui sont sous un format spécifiques, la plupart de ces documents sont aujourd'hui créés sous MS Word à partir de documents "masters" que l'on adapte à chaque équipement. Ils contiennent cependant des schémas, tableaux et images, des entêtes et pieds de page. La montée de version des documents est suivie à la main directement dans le fichier avec un tableau à remplir. Vous pouvez facilement imaginer les heures perdues à manipuler les fichiers, indiquer le numéro de série de l'équipement sur l'ensemble des documents, l'oubli d'éléments liés à telle ou telle option dans tel ou tel document, les erreurs possibles lorsque les masters utilisés ne sont pas à jour où lorsque l'on souhaite faire un équipement quasi identique à un ancien projet (et que le master utilisé pour celui-ci date). Les montées de versions aux modifications non tracées, etc... La difficulté de vérifier une nouvelle version car on n'a pas la trace exacte des modifications... Mon souhait ----------- La problématique m'a immédiatement fait penser à l'idée que je me fait du développement d'un programme informatique à l'aide de git. On a un master qui contient l'ensemble des options existantes, à partir duquel on crée des branches (chacun des équipement unique). Dans ces branches on sélectionne les options standardisées et on y ajoute les options spécifiques à cet équipement. Dans le cas où le master évolue, on pourrait faire des fusions afin d'appliquer ces "commit" à l'ensemble des branches qui en auraient besoin. De plus les différentes versions des documents pourraient représenter des tag. On pourrait même gérer la signature du document (équivalent des revues de code). Je rêve donc d'un système où, en sélectionnant la plateforme de base, les options standardisées, Mon souci --------- Aujourd'hui j'imagine que si j'étais seul, je créerai un dépot git, quelques scripts python pour fusionner des fichiers décrivant chaque options écris avec un format plain text (du type markdown). Et un fichier de config qui serait dans chacune des branches pour sélectionner les options. Seulement je ne suis pas seul, et les collègues qui travaillent sur ces dossiers ne sont pas familiers avec les outils de versionning propre à l'informatique. De plus je souhaiterais avoir un système qui ne repose pas tout entier sur moi pour le développement et le support. Pour de multiple raisons (pas maintenable si je quitte la boîte, donc ne sera pas accepté, et je ne suis pas développeur, je me lance dans ce projet car je souhaite améliorer l'existant, pas parce que c'est ma tâche). L'édition des documents doit pouvoir se faire avec un outil WYSIWYG. Mes collègues ne sont pas non plus totalement réfractaires à gérer les fichiers de façon différente (découper par option, etc...), mais aller sur du balisage et une gestion des images complexe serait rédhibitoire. La question ----------- Du coup je me tourne vers vous pour voir si vous connaissez des outils de gestion de documentation qui pourrait correspondre plus ou moins à ce que je recherche, ou du moins des pistes pour avancer ou en faire une partie. Désolé pour le long journal, j'ai souvent tendance à rentrer dans les détails pour être bien compris. Voici un peu ce que j'ai farfouillé pour l'instant, en vrac : Simul : https://www.simuldocs.com/ => propriétaire et au fonctionnement un peu obscur, pérenne dans le temps ? Publication : Weasyprint => comment l'intégrer dans le workflow ? Ecrire les documents en html ? Versionning : git et pandoc http://hrishioa.github.io/tracking-word-documents-with-git/ => manque la notion de merge Nota: Je suis ingénieur en mécanique et je ne suis pas développeur. J'utilise git pour des petit projets perso car je programme un peu dans mes temps libre, mais de façon très basique avec seulement 1 utilisateur.

AltStyle によって変換されたページ (->オリジナル) /