FAQ

Questions fréquentes

De vraies questions que les gens se posent avant d'adopter un registre de décisions.

Qu'est-ce que Decretum ?

Decretum est un registre de décisions : un historique structuré et consultable de ce qu'une organisation a décidé, qui l'a approuvé et pourquoi. Plutôt qu'une décision vive dans une réunion, un fil d'e-mails ou un message de chat, elle vit dans un registre de décision, avec sa discussion, ses étiquettes et un historique d'approbation nommé qui y est rattaché.

À qui s'adresse-t-il ?

À toute organisation où les décisions se prennent actuellement dans des endroits dispersés : réunions, e-mail, Teams ou Slack, sans moyen fiable de retrouver ensuite le raisonnement derrière l'une d'elles. Il est conçu pour toute l'organisation, pas seulement l'ingénierie : les équipes de conformité, d'achats et d'opérations prennent des décisions qui valent la peine d'être consignées aussi souvent que les équipes d'ingénierie.

Les personnes extérieures à l'équipe décisionnaire peuvent-elles voir ou commenter une décision ?

Oui, par défaut. La visibilité d'une décision est ouverte à toute l'organisation, sauf si quelqu'un la marque délibérément comme restreinte ; ainsi, toute personne de l'organisation peut la retrouver par la recherche et commenter directement le registre, même si elle n'a pas participé à la discussion d'origine. Cela compte parce que c'est souvent quelqu'un en dehors de la salle qui détient le contexte pertinent : une règle de conformité, une limitation technique, ou un engagement déjà pris envers un client. Le découvrir après la mise en œuvre de la décision est pire que de le découvrir pendant qu'elle est encore en cours.

En quoi est-ce différent d'un wiki comme Confluence ou Notion ?

Un wiki est conçu pour une documentation ouverte. Il n'impose pas qui a décidé, qui a approuvé et pourquoi comme données structurées. Ces faits finissent en texte narratif, quand ils sont écrits du tout. Un registre de décision fait de cette structure l'objectif même : le statut, les approbateurs et la justification sont des champs, pas des paragraphes que vous devez penser à inclure.

En quoi est-ce différent d'un outil de registre de décisions d'architecture (ADR) ?

Les outils d'ADR résolvent bien ce problème, mais seulement pour les équipes d'ingénierie travaillant dans un dépôt de code. Le même problème, des décisions sans registre consultable de qui et pourquoi, existe tout aussi souvent en dehors de l'ingénierie. Decretum est conçu pour toute l'organisation, pas seulement pour les développeurs.

Decretum peut-il être auto-hébergé ?

Oui. Decretum se déploie comme service cloud géré ou comme déploiement auto-hébergé, sur site, via Docker, fonctionnant sur votre propre infrastructure avec votre propre base de données. Les deux sont la même application. Consultez la page sécurité et déploiement pour plus de détails.

Comment les gens se connectent-ils ?

Avec e-mail et mot de passe, Google, ou Microsoft Entra ID, pour que l'accès suive le fournisseur d'identité que votre organisation utilise déjà. Les déploiements auto-hébergés peuvent aussi se connecter à n'importe quel fournisseur d'identité conforme à OpenID Connect qu'ils exploitent eux-mêmes, comme Keycloak, pour une connexion qui ne nécessite jamais d'accès Internet.

Comment les personnes rejoignent-elles une organisation ?

La première personne à s'inscrire devient l'administrateur de cette organisation, qu'il s'agisse d'un nouvel espace Cloud ou du tout premier compte d'un déploiement Auto-hébergé fraîchement créé. À partir de là, les administrateurs invitent le reste de l'équipe depuis la page Utilisateurs, par e-mail, un par un ou en collant une liste entière à la fois, chacun avec le rôle (lecteur, contributeur, approbateur ou administrateur) avec lequel il doit commencer.

Faut-il que quelqu'un approuve chaque décision ?

L'approbation fait partie du flux de travail, sans être obligatoire pour chaque registre. Les équipes qui veulent un historique d'approbation formel (un approbateur nommé et sa justification consignée) peuvent l'exiger. Les équipes qui veulent simplement un journal consultable de ce qui a été discuté et décidé peuvent utiliser Decretum sans cela.

Une personne peut-elle supprimer son compte ou exporter ses données ?

Oui. Chacun peut exporter ses propres données sous forme de fichier JSON, ou demander la suppression de son propre compte, à tout moment. La suppression se déroule en deux étapes : le compte est désactivé immédiatement et récupérable pendant 14 jours, puis le nom et l'e-mail de la personne sont définitivement remplacés. Les décisions et publications qu'elle a rédigées restent en place, attribuées à « Utilisateur supprimé », dans le cadre du registre de l'organisation. Decretum est un registre de décisions immuable, une décision ne disparaît donc pas parce que la personne qui l'a prise a disparu.