Eine Knowledge Base erstellen

Eine neue Knowledge Base besteht grundsätzlich aus einer Beschreibung und einer Navigation.

1. Knowledge Base anlegen

Zunächst wird die Knowledge Base selbst definiert.

Dazu gehören beispielsweise:

• eindeutige ID
• Titel
• Beschreibung
• verfügbare Sprachen
• Navigation

2. Sections definieren

Anschließend werden die thematischen Bereiche angelegt.

Beispiel:

sections:
  - id: basics
    title:
      de: Grundlagen
      en: Basics

  - id: security
    title:
      de: Sicherheit
      en: Security

3. Artikel hinzufügen

Anschließend werden Artikel erstellt.

Beispiel:

what-is-phishing.md
suspicious-links.md
fake-login-pages.md

Jeder Artikel besitzt eine eindeutige ID.

4. Artikel der Navigation zuordnen

Die Artikel werden anschließend in der Navigation referenziert:

sections:
  - id: basics
    title:
      de: Grundlagen
      en: Basics
    items:
      - id: what-is-phishing
      - id: why-phishing-works

Die Navigation entscheidet damit, wo ein Artikel angezeigt wird.

Ergebnis

Die fertige Knowledge Base besteht somit aus:

Knowledge Base
│
├── Konfiguration
│
├── Navigation
│
└── Artikel
    ├── Artikel 1
    ├── Artikel 2
    └── Artikel 3

Diese Struktur kann später sowohl für fest hinterlegte Knowledge Bases als auch für von Benutzern erstellte Knowledge Bases verwendet werden.