MaleusMaleus

Connecter une base de connaissances et la consulter dans le projet

Rattachez des spaces Confluence à votre projet, puis lisez et modifiez les pages synchronisées depuis la section Documents du projet.

Dans l'appParamètres du projet
Sur cette page

Maleus expose deux surfaces pour les documents : un onglet Réglages → Documents où un admin connecte les sources externes, et une section Documents dans la sidebar du projet où tout le monde lit ou modifie les pages que ces sources exposent. Confluence est la source branchée aujourd'hui. Notion, Google Docs et SharePoint sont pour l'instant des placeholders.

Connecter Confluence (admin uniquement)

Confluence se configure d'abord au niveau du workspace (dans les réglages de la plateforme), puis s'active projet par projet.

  1. Ouvrez le projet, puis Réglages.
  2. Dans le drill Réglages de la sidebar, choisissez Documents.
  3. La carte Confluence montre l'état courant.
    • « Non configuré. Demandez à un administrateur de le mettre en place dans les réglages de la plateforme. » si le workspace n'a pas encore d'identifiants Confluence.
    • La liste des spaces disponibles avec des cases à cocher une fois configuré.
  4. Cochez les spaces que ce projet doit lire.
  5. Cliquez sur Enregistrer les modifications (ou Réinitialiser pour abandonner).

Une fois enregistrés, les spaces sélectionnés apparaissent dans la section Documents du projet.

Parcourir et modifier un document

Ouvrez Documents depuis la sidebar du projet. Chaque document s'ouvre dans un viewer adapté à son type.

L'arborescence à gauche, le document à droite, avec Éditer et Télécharger dans l'en-tête.

TypeViewer
MarkdownÉditeur avec bascule Modifier / Aperçu et Télécharger
Texte brut, JSON, CSV / tableurAperçu en lecture seule
PDF, DOCXViewer intégré
Tout le resteTéléchargement de repli

L'en-tête permet de renommer en place un document non Markdown. Pour le Markdown, le titre se modifie depuis le panneau d'édition. Vous pouvez aussi étiqueter le document avec une catégorie depuis le popover Ajouter une catégorie (en choisir une existante ou en créer une à la volée).

Ajouter un document

Le + à côté de Documents dans l'arborescence ouvre le sélecteur de source.

Trois entrées aujourd'hui, trois autres annoncées.

SourceCe qu'elle fait
Write from scratchUn document Markdown vierge que vous écrivez sur place.
Upload a fileImporter un fichier .md, .txt, .pdf, .csv, .json, .xlsx ou .docx.
From ConfluenceImporter une page depuis les espaces que ce projet a le droit de lire.

From Notion, From Google Docs et From SharePoint sont annoncés comme à venir.

Synchronisation Confluence

Les documents tirés de Confluence portent un badge Confluence dans l'en-tête. Un bouton Synchroniser rafraîchit la page depuis la source. La synchronisation est à sens unique : le document dans Maleus se met à jour depuis Confluence, jamais l'inverse.

Quand vous affinez des specs avec l'agent, il peut tirer du contexte de n'importe quel document que vous avez sélectionné. Connecter votre space Confluence de specs techniques est un moyen rapide de lui donner le contexte dont il a besoin.

Comportement d'enregistrement

Pour les documents Markdown que vous écrivez vous-même, l'éditeur signale Modifications non enregistrées dans la barre du bas. Appuyez sur ⌘S (ou Ctrl+S sur Linux/Windows) ou cliquez sur Enregistrer. Le bouton passe à Enregistrement… pendant la requête.