Files
pablan/help/wissen-festhalten.de.md
ProfessorNovaandClaude Opus 5 784b76baf7 Pablan, as it stands
Self-hosted knowledge management for SMEs: a split-screen Markdown editor
whose sections an LLM refines while you write, and RAG question answering
over the documents that result. FastAPI + Postgres/pgvector on the back,
SvelteKit on the front, everything OpenAI-compatible and self-hostable.

Squashed into a single commit; the development history stays local.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CA43ZJda8Rbp2hKXNy8f6b
2026-09-04 09:21:37 +02:00

5.8 KiB

key, title
key title
wissen-festhalten Wissen festhalten: schreiben mit Assistenz

Wissen festhalten: schreiben mit Assistenz

Wissen festzuhalten heißt in Pablan: Du schreibst das Dokument selbst, und das Modell hilft dir beim Formulieren. Du musst nicht wissen, wie man sauber gliedert — die Dokumentationsart gibt dir ein Gerüst aus Überschriften vor, und du füllst es in deinen eigenen Worten.

Ablauf

  1. Dokumentationsart wählen. Über "Wissen festhalten" erscheint die Liste der verfügbaren Arten. Jede Art ist ein Markdown-Gerüst mit den Überschriften, die zu dieser Art gehören — und die Überschriften sind genau die Fragen, die eine Kollegin dir stellen würde:

    • Ablauf: wie wir das machen — wann das gilt, Schritt für Schritt, wenn es klemmt, wer zuständig ist.
    • Störung: was los war und was geholfen hat — für die Nachbereitung, solange es frisch ist.
    • Über dich: Rolle und Ansprechbarkeit — dein eigenes Dokument, siehe "Kolleg:innen und dein Profil".
    • Notiz: einfach aufschreiben — bewusst ohne Gerüst, wenn du schon weißt, was du sagen willst.

    Je nach Unternehmen kommen weitere Arten dazu; das legt die Administration fest. Startest du das Festhalten aus einem Chat heraus, zeigt Pablan dir zusätzlich passende bestehende Dokumente an — so kannst du ein vorhandenes Dokument erweitern, statt neu anzufangen.

  2. Schreiben. Es öffnet sich ein geteilter Editor. Links schreibst du das Dokument — direkt in Markdown, entlang der vorgegebenen Überschriften. Du musst nichts einleiten und in keiner bestimmten Reihenfolge vorgehen.

  3. Vorschlag übernehmen. Machst du beim Tippen eine kurze Pause, schlägt Pablan rechts eine ausformulierte Fassung des Abschnitts vor, an dem du gerade schreibst — aus deinen Stichworten wird reifer Text, ohne dass Fakten dazukommen. Übernehmen ersetzt den Abschnitt links durch den Vorschlag. Danach schreibst du weiter; sobald genug neuer Text steht, kommt der nächste Vorschlag.

  4. Speichern. Unten rechts sitzt Speichern. Bevor gespeichert wird, zeigt Pablan dir eine übersichtliche Zeilen-Ansicht — wie in einem Code-Editor: was hinzugekommen, was geändert und was entfernt wurde. So siehst du genau, was du seit dem letzten Stand geändert hast, und kannst immer noch abbrechen. Darüber steht der Titel zum Ändern — hier fällt einem auf, wenn das Dokument noch den Namen der Vorlage trägt. Über das Sternchen daneben schlägt Pablan dir einen Titel aus dem Inhalt vor. Das gilt genauso, wenn du ein bestehendes Dokument überarbeitest.

  5. Veröffentlichen. Solange du nicht veröffentlichst, gehört der Entwurf nur dir. Veröffentlichen ist deine eigene Entscheidung und ein Klick — im Speichern-Dialog als Speichern und veröffentlichen, auf der Dokumentenseite oder direkt von der Startseite aus, die dir deine nicht veröffentlichten Entwürfe anzeigt. Danach bestätigt dir Pablan, dass dein Wissen festgehalten ist, und bietet dir an, es prüfen zu lassen.

  6. Prüfen lassen, wenn du unsicher bist. Du kannst jederzeit eine Kollegin oder einen Kollegen bitten, das Dokument anzusehen, und dazuschreiben, worum es geht — zum Beispiel "Stimmt das so mit den 14 Urlaubstagen?". Mehr dazu unter "Dokumente, Sichtbarkeit und Prüfung".

Der Vorschlag rechts

Der Vorschlag betrifft immer nur den Abschnitt, an dem du gerade schreibst — nicht das ganze Dokument. Das hält lange Dokumente übersichtlich und die Vorschläge schnell.

  • Der Vorschlag erscheint, während du eine Pause machst, und baut sich Wort für Wort auf. Tippst du weiter, bricht er ab — du unterbrichst also nichts.
  • Übernehmen überschreibt genau diesen einen Abschnitt links. Was du an anderer Stelle geschrieben hast, bleibt unangetastet.
  • Nach dem Übernehmen kommt der nächste Vorschlag erst, wenn du wieder genug Neues geschrieben hast. So drängt sich die Assistenz nicht auf.

Du entscheidest jederzeit, ob du einen Vorschlag übernimmst oder bei deiner eigenen Formulierung bleibst. Das Dokument links ist immer die Wahrheit — der Vorschlag rechts ist nur ein Angebot.

Wenn keine Art passt

Dann nimm Notiz: einfach aufschreiben. Die hat bewusst gar kein Gerüst: Du fängst mit einem leeren Dokument an, schreibst in deinen Worten, und Pablan formuliert Abschnitt für Abschnitt mit. Überschriften setzt du selbst, wo du sie brauchst.

Was mit dem Entwurf passiert

Unter dem Editor steht, woran du bist: ein neuer Entwurf, der beim Verlassen verworfen wird, solange du nichts geschrieben hast — ein Entwurf, den nur du siehst — oder die Uhrzeit des letzten Speicherns.

Läuft gerade kein Sprachmodell, sagt Pablan das einmal und stellt die Vorschläge still, statt es alle paar Sekunden erneut zu versuchen. Schreiben kannst du normal weiter; über Jetzt erneut versuchen holst du die Vorschläge zurück, sobald der Endpunkt wieder läuft.

Im Editor änderst du Titel und Text. Wer das Dokument sehen darf, stellst du in der Dokumentansicht ein — dort, wo du es auch mit weiteren Abteilungen teilst. Das ist die Entscheidung der Autorin: Wer nur um eine Prüfung gebeten wurde, darf den Text korrigieren, aber nicht die Sichtbarkeit ändern.

Was du schreibst, ist von Anfang an das Dokument, nicht eine Vorschau davon. Es gehört zunächst nur dir und taucht in keiner Suche auf — auch dann nicht, wenn du es tagelang liegen lässt. Erst wenn du veröffentlichst, wird es im Rahmen der eingestellten Sichtbarkeit gefunden. Vorher wie nachher kannst du Titel, Text und Sichtbarkeit frei ändern.

Verlässt du den Editor mit ungespeicherten Änderungen, sichert Pablan sie im Entwurf, damit nichts verloren geht. Ein Gerüst, in das du nie etwas geschrieben hast, wird stattdessen verworfen — so sammeln sich keine leeren Entwürfe an.