Aufbau einer Knowledge Base

Eine Knowledge Base besteht aus mehreren Ebenen.

Knowledge Base
│
├── Navigation
│   ├── Section
│   │   ├── Article
│   │   ├── Article
│   │   └── Article
│   │
│   └── Section
│       ├── Article
│       └── Article
│
└── Inhalte
    ├── Markdown
    ├── Metadaten
    └── weitere Informationen

Knowledge Base

Die Knowledge Base ist der übergeordnete Container.

Sie definiert beispielsweise:

• Namen
• Beschreibung
• Sprache
• Navigation
• Bereiche
• enthaltene Artikel

Eine Anwendung kann mehrere Knowledge Bases bereitstellen.

Beispielsweise:

Knowledge Bases
├── IT Security
├── Development
├── Home Server
└── Project Documentation

Sections

Sections gruppieren Artikel thematisch.

Eine Section kann beispielsweise Basics, Detection oder Protection heißen.

Sections enthalten selbst keine eigentlichen Inhalte. Sie verweisen auf die zugehörigen Artikel.

Articles

Artikel enthalten den eigentlichen Inhalt.

Die Artikel werden als Markdown-Dateien gespeichert bzw. verarbeitet.

Ein Artikel kann beispielsweise so aussehen:

what-is-phishing.md

Die Navigation verweist anschließend über eine ID auf diesen Artikel.

Trennung von Navigation und Inhalt

Die Trennung von Navigation und Inhalt hat einen wichtigen Vorteil:

Die Reihenfolge und Gruppierung der Artikel kann geändert werden, ohne den Artikel selbst bearbeiten zu müssen.

Dadurch können Inhalte wiederverwendet und einfacher verwaltet werden.