Joule-Wiki

Mitmachen — README.md

3 Min. Lesezeit

Spiegelseite

Dies ist die Wiki-Browser-Version. Die Originaldatei liegt im Projekt-Root unter README.md und dient Git/GitHub/GitLab als Projekt-Startseite. Änderungen bitte in beide Versionen einpflegen.

SAP-Joule-Wiki des ADVIA-Joule-Teams

Willkommen. Dieses Repository ist unser gemeinsames, lebendes Wissen rund um SAP Joule — gepflegt von Menschen und KI.

Warum dieses Wiki?

Unser Wissen zu Joule ist bisher verstreut: in Mailverläufen, SAP-Newslettern, Projektberichten, Folien und Kopfschubladen. Jede Anfrage eines Kunden beginnt wieder bei Null. Dieses Wiki soll das ändern: ein zentrales, persistentes Artefakt, das mit jeder neuen Quelle und jeder Frage reicher wird.

Das Vorbild: Andrej Karpathys LLM-Wiki-Pattern. Kernidee: Die KI macht die mühsame Pflegearbeit (Zusammenfassen, Querverweise, Konsistenz). Wir Menschen kuratieren, fragen und entscheiden.

Wie mache ich mit?

Es gibt zwei Wege. Beide sind willkommen.

Weg 1 — Einfach: Dokument droppen

Du hast ein Dokument, das ins Wiki sollte (SAP-Whitepaper, Folien einer Kundenpräsentation, Meetingnotizen)?

  1. Lege die Datei in raw/.inbox/ ab.
  2. Gib dem KI-Agenten (Claude, z.B. im Cowork-Modus oder Claude Code) Bescheid:

    „Integriere die neue Datei in raw/.inbox/ ins Wiki.”

  3. Die KI liest, fasst zusammen, verlinkt und aktualisiert betroffene Seiten. Du bekommst einen kurzen Bericht.
  4. Prüfe das Ergebnis und gib Feedback.

Details: siehe Raw-Anleitung.

Weg 2 — Für Fortgeschrittene: Markdown direkt editieren

Du kennst dich mit Markdown aus und willst eine Seite selbst schreiben oder überarbeiten?

  1. Clone das Repo lokal (später: vom Aequitas-Server).
  2. Öffne es in Obsidian (empfohlen) oder VS Code.
  3. Orientiere dich an den Konventionen im Schema (CLAUDE.md) — vor allem Frontmatter und Wikilinks [[...]].
  4. Commit und push, oder schick die geänderte Datei an Martin.

Was passiert automatisch?

Wenn du mit der KI arbeitest, folgt sie dem Schema in Schema (CLAUDE.md):

  • Ingest: neue Rohquelle → Zusammenfassung + Cross-Links über ~5–15 Seiten.
  • Query: du fragst, die KI antwortet anhand des Wikis, optional als neue Seite speicherbar.
  • Lint: periodischer Gesundheitscheck (Widersprüche, Orphans, veraltete Inhalte).

Wo finde ich was?

Technik (aktueller Stand)

  • Format: reines Markdown mit Obsidian-Syntax (Wikilinks, Callouts, Tags).
  • Host: zunächst lokal auf Martins Rechner, später Aequitas-interner Server.
  • Viewer: Zwei Wege nebeneinander:
    • Obsidian (empfohlen zum Bearbeiten) — Vault auf das Repo-Verzeichnis zeigen lassen.
    • Quartz (statische Webansicht) — für Kollegen, die nur stöbern wollen.
  • Versionierung: Git — jede Änderung ist nachvollziehbar.

Quartz lokal starten (Docker)

Für den schnellsten Einstieg: Docker Desktop installieren, dann im Repo-Verzeichnis:

Produktionsbetrieb (fertiger Build, über Nginx):

docker compose up --build wiki
# → http://localhost:8080

Entwicklungsmodus (Live-Reload beim Schreiben):

docker compose up wiki-dev
# → http://localhost:8080

Ohne Docker (direkt mit Node):

npm install
npx quartz build --serve

Anforderungen: Node.js ≥ 22, npm ≥ 10.9.

Die Konfiguration steckt in quartz.config.ts (Titel, Farben, Locale) und quartz.layout.ts (Kopfzeile, Seitenleiste, Fußzeile).

Deployment auf den Aequitas-Server (später)

  • Statisch: npx quartz build → public/-Inhalt auf einen Webserver (nginx, IIS) legen.
  • Docker: Das mitgelieferte Dockerfile baut einen Container, der Quartz serviert.
  • CI/CD: Bei Push auf main automatisch bauen und deployen (z.B. GitLab CI, GitHub Actions).

Kontakt

Fragen oder Ideen? → Martin Arnold (martin.arnold@advia.de)

← Meta · Inhaltsverzeichnis

Graphansicht

Backlinks