munin/internal/hilfe/seiten/weboberflaeche.md

Die Weboberfläche ist der Zugang für Menschen. Sie zeigt dasselbe Wissen, das auch die Agenten sehen.

Anmelden

Angemeldet wird mit dem API-Key des Projekts, also demselben, den auch das KI-Werkzeug benutzt. Einen Benutzernamen gibt es nicht: Der Key bestimmt, wer du bist, in welchem Projekt du arbeitest und was du darfst. Wird der Key zurückgezogen, endet auch die Sitzung im Browser sofort.

Finden

• Suchen: Das Suchfeld über der Eintragsliste durchsucht Titel, Schlagworte und Inhalt. Titel zählen am stärksten. Umlaute sind egal: „Uberblick“ findet auch „Überblick“. Ein Wortanfang reicht, „deploy“ findet auch „Deployment“.
• Nach Schlagwort filtern: In der Seitenleiste stehen alle Schlagworte des Projekts, die häufigsten zuerst. Ein Klick filtert die Liste.
• Verweisen folgen: Unter jedem Eintrag steht, welche anderen Einträge auf ihn verweisen.
• Graph: Unter Graph in der Seitenleiste zeigt Munin, wie die Einträge über Verweise zusammenhängen. Gestrichelte Knoten sind Verweisziele, zu denen es noch keinen Eintrag gibt. Mausrad zoomt, Ziehen verschiebt, ein Klick öffnet den Eintrag. Bei sehr großen Projekten zeigt der Graph nur die 150 am stärksten verknüpften Einträge.

Schreiben

Mit der Rolle write oder admin gibt es über der Liste den Knopf Neuer Eintrag und in jedem Eintrag Bearbeiten.

Feld	Bedeutung
Titel	Worum es geht, am besten als Frage oder klares Thema
Bezeichner	Der dauerhafte Name, siehe Begriffe. Leer lassen, dann wird er aus dem Titel abgeleitet.
Schlagworte	Durch Komma getrennt. Möglichst vorhandene wiederverwenden.
Inhalt	Markdown (siehe unten)
Kuratiert	Haken setzen, wenn der Inhalt geprüft und verlässlich ist

Bevor du einen neuen Eintrag anlegst, such kurz, ob es das Thema schon gibt. Ergänzen ist fast immer besser als ein zweiter Eintrag.

Markdown im Inhalt

Unterstützt werden die üblichen Auszeichnungen:

## Zwischenüberschrift

Normaler Text mit **fett**, *kursiv* und `Code`.

- Aufzählung
- noch ein Punkt

1. Nummerierte Schritte
2. zweiter Schritt

[Ein Link](https://example.org)

Siehe auch [[anderer-eintrag]].

Dazu kommen die Erweiterungen, die man von GitHub oder GitLab kennt:

| Umgebung | Adresse        |
|----------|----------------|
| Test     | test.intern    |
| Prod     | prod.intern    |

- [x] erledigt
- [ ] noch offen

~~veraltet~~ — durchgestrichen

https://example.org wird ohne Klammern zum Link.

Codeblöcke stehen zwischen drei Backticks. Eingebettetes HTML wird aus Sicherheitsgründen nicht ausgeführt.

Verweise mit Autovervollständigung

Tippe [[ in das Inhaltsfeld. Munin schlägt passende Einträge vor. Mit den Pfeiltasten auswählen und mit Enter oder Tab übernehmen, oder einfach anklicken. Eingefügt wird der Bezeichner, nicht der Titel.

Vorschau

Über dem Inhaltsfeld wechselst du zwischen Schreiben und Vorschau. Die Vorschau zeigt den Eintrag genau so, wie er nach dem Speichern aussehen wird.

Wenn jemand gleichzeitig ändert

Hat jemand anderes (ein Mensch oder ein Agent) den Eintrag geändert, während du ihn bearbeitet hast, meldet Munin beim Speichern einen Konflikt, statt die fremde Änderung zu überschreiben. Dein Text bleibt im Formular erhalten. Öffne den Eintrag in einem zweiten Tab, übernimm dort deine Änderungen in den aktuellen Stand und speichere dann dort.

Verlauf und Vergleich

In jedem Eintrag führt Fassung n, Verlauf ansehen zu allen früheren Fassungen. Bei jeder Fassung zeigt Änderungen ansehen Zeile für Zeile, was sich zur nächsten Fassung geändert hat. So lässt sich nachvollziehen, was ein Agent geändert hat.

Mit Schreibrecht holt Wiederherstellen (im Verlauf oder auf der Vergleichsseite) eine alte Fassung mit einem Klick zurück: Titel, Inhalt und Schlagworte. Dabei geht nichts verloren — der bisherige Stand wird selbst zu einer Fassung im Verlauf, und das Protokoll vermerkt, welche Fassung zurückgeholt wurde. Hat jemand den Eintrag geändert, während du den Verlauf angesehen hast, wird nichts überschrieben; prüfe dann den neuen Stand und versuche es erneut.

Papierkorb

Löschen legt einen Eintrag in den Papierkorb, egal ob ein Mensch in der Oberfläche löscht oder ein Agent über forget. Der Eintrag verschwindet sofort aus Liste, Suche, Graph und allen Antworten an Agenten. Mit Verlauf und Schlagworten bleibt er aber 30 Tage erhalten; danach entfernt Munin ihn endgültig.

Den Papierkorb findest du mit Schreibrecht in der Seitenleiste. Dort steht zu jedem Eintrag, wer ihn wann gelöscht hat:

• Wiederherstellen holt einen Eintrag unverändert zurück.
• Endgültig löschen entfernt ihn sofort, samt Verlauf. Das ist gedacht für Inhalte, die nicht 30 Tage liegen bleiben sollen, etwa ein versehentlich abgelegtes Passwort. Rückgängig machen lässt sich das nicht.
• Ein Klick auf den Namen eines Zugangs zeigt nur, was dieser gelöscht hat. Hat ein Agent zu gründlich aufgeräumt, holt Alle … wiederherstellen alles auf einmal zurück.

Wer mit Leserecht angemeldet ist, sieht den Papierkorb nicht. Oft wird ein Eintrag ja gerade deshalb gelöscht, weil nicht jeder ihn sehen soll.

Legst du einen Eintrag mit einem Bezeichner an, der noch im Papierkorb liegt, holt Munin den alten Eintrag zurück und überschreibt ihn. Der gelöschte Stand steht dann im Verlauf, und ein Hinweis sagt dir, dass das passiert ist.

Veraltetes trotzdem lieber überarbeiten als löschen: Überarbeitetes bleibt auffindbar, und der Verlauf zeigt, was sich geändert hat.

Viele Einträge auf einmal

Mit Schreibrecht hat die Eintragsliste vor jedem Eintrag ein Auswahlkästchen. Unter der Liste lassen sich für alle ausgewählten Einträge Schlagworte hinzufügen oder entfernen, mehrere durch Komma getrennt. Praktisch, um ein Schlagwort umzubenennen: das neue hinzufügen, das alte entfernen.

Protokoll

Unter Protokoll in der Seitenleiste steht, wer im Projekt wann etwas geschrieben, gelöscht oder sich angemeldet hat.