Information
Artidoc est un service disponible uniquement avec l’offre Tuleap Enterprise.
Artidoc est une fonctionnalité native de Tuleap Enterprise qui permet de créer des documents projet collaboratifs directement au sein de l’environnement ALM.
Chaque section du document peut être “associée à” ou “transformée en” un artifact traçable, panifiable et auditable, entièrement connecté aux autres outils Tuleap (trackers, kanbans, roadmaps, etc.).
Artidoc devient ainsi un espace centralisé pour :
Rédiger des spécifications fonctionnelles.
Formaliser les besoins, risques et décisions.
Assurer la traçabilité des exigences et des preuves de conformité.
Générer automatiquement des tickets ou des user stories.
Produire des documents audités et facilement partageables.
Artidoc est un type de document spécifique. Chaque section du document correspond à un artifact.
Une fois le document artidoc créé, il doit être configuré avec un système de suivi. Ce système servira à créer de nouvelles sections.
Veuillez noter que la configuration peut être modifiée pendant la durée de vie du document ; le nouveau système de suivi sélectionné n'affecte que les nouvelles sections, les sections existantes resteront inchangées.
Un document qui vit avec le projet
Avec Artidoc, les documents ne sont plus des captures figées de l’intention. Ils deviennent des vues vivantes, fiables et synchronisées de l’exécution du projet.
Grâce à l’affichage en lecture seule des champs d’artifacts (disponible depuis la version 16.12), vous pouvez directement dans le document :
Consulter instantanément le statut d’une exigence (en cours, validée, rejetée, etc.).
Vérifier la couverture de test ou l’association à un scénario de validation.
Identifier les dépendances entre artifacts, leurs priorités, versions ou responsables.
Préparer un audit ou une revue projet sans ressaisie ni synthèse manuelle.
La documentation devient un tableau de bord clair, personnalisable et prêt pour l’audit.
Résultat : vous ne vous contentez plus d’écrire des documents, vous pilotez le projet avec eux.
Exemple d’usage : spécification, besoin, exigence
Imaginons la formalisation d’une exigence pour un composant critique dans Artidoc.
Depuis le document, vous visualisez immédiatement :
Son statut de validation (approuvée par le Product Owner ou non).
Sa priorité.
Les tests qui la couvrent.
Le ticket associé à son implémentation.
Le tout sans jamais quitter le document.
Et si le statut, la priorité ou la couverture évoluent dans le Tracker ? La vue dans Artidoc se met à jour automatiquement, garantissant une information toujours à jour et fiable.
Fonctionnalités clés
Catégorie | Fonctions Artidoc |
|---|---|
Rédaction | Éditeur enrichi (Markdown/WYSIWYG), support images, emojis, headers, mode Zen. |
Structuration | Table des matières, tri des sections par glisser-déposer, templates. |
Connexion projet | Création/liaison d’artefacts depuis le texte, champs et métadonnées, synchronisation automatique. |
Collaboration | Edition simultanée, commentaires, historique, permissions fines. |
Publication | Export PDF/ODT, templates personnalisables (logo, couverture, pied de page). |
Sécurité | Respect des permissions utilisateurs Tuleap, hébergement on-premise ou souverain. |
Cas d’usage typique
Cas d’usage | Objectif | Ce que fait Artidoc |
|---|---|---|
Spécifications agiles | Formaliser les besoins, générer des stories | Création d’exigences ou user stories depuis le texte. |
Conformité réglementaire | Justifier les exigences, tests, preuves | Inclusion de métadonnées + Champs + artefacts traçables dans le doc. |
Document d’audit | Préparer une livraison ou inspection client | Affichage filtré + export PDF certifiable. |
Compte-rendu de sprint / réunion | Capitaliser sur les décisions | Tracker “décision” intégré dans le document. |
Release note utilisateur | Générer automatiquement un guide de version | Sections liées aux artefacts de release + images + tags. |
Ce que l’on gagne avec Artidoc
Productivité
• Moins de double saisie : plus besoin de copier-coller les specs vers le backlog ou les tickets.
• Moins d’erreurs de version : les champs (statut, priorité…) se mettent à jour seuls.
Visibilité
• Toute l’équipe voit le même état du projet, même dans un document.
• Meilleure lisibilité pour les parties prenantes externes (clients, qualité, partenaires…).
Conformité
• Documents auditables et exportables à tout moment.
• Traçabilité directe entre besoin, preuve, plan, livrable.
Intégration totale Tuleap
• Trackers : chaque artefact est lié, filtrable.
• Kanban : statut visible sans quitter le document.
• Roadmap : impact visible, planifiable.
• Tableaux de bord : données extraites en temps réel.