KNOWLEDGE-MANAGEMENT

Referenz-Building-Block – Wissensverwaltung#

Zweck#

Knowledge Management verwaltet Wissen als identifizierbare, versionierte und mehrsprachige Artefakte. Dokumentation, Hilfe, Suche und Publikation sind Materialisierungen oder Nutzungssichten dieser Wissensartefakte, nicht automatisch deren führender Arbeitszustand.

Der Reference ⌘Building BlockEin Building Block ist ein abgegrenzter Baustein mit stabiler Verantwortung zur Realisierung von Capabilities. beschreibt eine universelle Verantwortung. Eine konkrete Solution oder Plattform spezialisiert ihn für ihren Lösungsraum, ohne die Enterprise-Semantik neu zu definieren.

Verantwortungsprinzip#

Wissensverantwortung bleibt dezentral bei der fachlichen Heimat des jeweiligen Inhalts. Ein Help System, Knowledge Portal, Suchdienst oder Aggregator darf Wissen auffindbar und nutzbar machen, übernimmt dadurch aber keine fachliche Inhaltshoheit.

Knowledge Management stellt sicher, dass Wissen:

• eine stabile Identity besitzt,
• einem fachlichen Scope und Owner zugeordnet ist,
• seine ⌘ProvenanceProvenienz beschreibt die nachvollziehbare Herkunft eines Wissenselements, einer Aussage oder einer abgeleiteten Darstellung. und Quellbeziehungen bewahrt,
• review- und versionsfähig bleibt,
• über Beziehungen in den Wissensgraphen eingebunden wird,
• in geeigneten Sprach- und Präsentationsformen materialisiert werden kann.

Wissensarten#

Mindestens folgende Wissensartefakte werden unterschieden:

• Glossary Entry: definiert einen Begriff und dessen gültigen Kontext.
• ⌘Learning NuggetDidaktisches Wissensartefakt, das ein Architektur- oder Technikthema verständlich erklärt, ohne normative Architekturregeln zu ersetzen.: erklärt einen Zusammenhang, eine Entscheidung oder einen typischen Fehler.
• Help Context: erklärt eine konkrete Bedienhandlung, einen Zustand, ein Feld, einen Command oder eine View.
• Tutorial: führt durch eine erlernbare Handlung oder einen Ablauf.
• Example: veranschaulicht ein Konzept oder eine Regel.
• FAQ: beantwortet eine abgegrenzte wiederkehrende Frage.
• Guideline: beschreibt handlungsleitende Regeln innerhalb eines definierten Scopes.
• Knowledge Story oder Pattern: vermittelt verallgemeinerbare Erfahrung in narrativer oder wiederverwendbarer Form.

Konkrete Solutions dürfen weitere Wissensarten profilieren, sofern deren Semantik und fachliche Heimat eindeutig bleiben.

Knowledge References#

Wissensartefakte und andere Artefakte werden mit typisierten semantischen Beziehungen verbunden, beispielsweise:

defines, explains, example-for, prerequisite, related, source-of, help-for, derived-from, validates, ⌘supersedessupersedes bedeutet: Ein neuer Stand löst einen früheren Stand explizit ab..

Freitextverweise dürfen strukturierte Beziehungen ergänzen, aber nicht ersetzen, wenn eine stabile Identity vorhanden ist.

Grundregel#

Knowledge is modeled as artifacts, not as detached documentation.

Damit gelten stabile Identity, Sprachvarianten, Revisionen, Beziehungen, Dimensionen, Audit, Review, Übersetzung sowie Import und Export.

Knowledge Lifecycle#

Knowledge Management unterstützt den Übergang von Beobachtung und ⌘EvidenceTechnical documentation artifact. zu dauerhaftem Wissen:

Observation
                → Finding
                → Analysis
                → Decision or Rule
                → Implementation
                → Verification
                → Evidence
                → Learning
                → konsolidiertes semantisches Modell

Nicht jede Beobachtung wird unmittelbar zu Enterprise-Wissen. Erst validierte und ausreichend verallgemeinerbare Erkenntnisse werden auf eine höhere Architekturebene promoviert.

UI- und Help-Integration#

Jedes sichtbare oder ausführbare UI-Artefakt soll einen stabilen Help Context besitzen. Dieser kann auf Glossar, Learning Nuggets, Capabilities, Building Blocks, Entscheidungen, Findings, Quellrevisionen und Evidence verweisen.

Ein Help Context bleibt fachlich beim verantwortlichen ⌘ArtefaktEin Artefakt ist jede eindeutig identifizierbare fachliche, technische, organisatorische oder reale Einheit, die in der Engineering-Landschaft modelliert wird.. Eine zentrale Hilfeansicht aggregiert ihn lediglich.

Suche und Auffindbarkeit#

Knowledge Management ermöglicht Auffindbarkeit über:

• Identity und Alias,
• Volltext und Schlagwörter,
• Collections und Topics,
• typisierte Beziehungen,
• Sprache und Terminologie,
• fachlichen Scope und Zielgruppe,
• Provenance und Quellrevision.

Suchindizes, Embeddings oder LLM-basierte Suche sind mögliche Solution-Realisierungen. Sie gehören nicht zur universellen Definition des Wissens.

Mehrsprachigkeit#

Stabile IDs, Reason Codes und technische Referenzen werden nicht übersetzt. Menschenlesbare Inhalte können mehrere Sprachfassungen besitzen. Alle Sprachfassungen referenzieren dieselbe semantische Identity und bewahren die Originalsprache sowie die Provenance.

Materialisierung#

• Tooltip: kurze, kontextgebundene Materialisierung.
• Knowledge Panel: ausführliche Hilfe, Begriffe, Nuggets und Quellen.
• Markdown, HTML, UI oder API: unterschiedliche Materialisierungen derselben Wissensartefakte.
• Generierte oder übersetzte Texte benötigen nachvollziehbaren Status und Review.
• Quellenänderungen können abhängige Inhalte als outdated markieren.

Abgrenzung#

Dieser Reference Building Block definiert keine konkrete Datenbank, API, Suchmaschine, UI-Komponente, Rankinglogik oder Publikationspipeline. Solche Entscheidungen gehören in die jeweilige Solution Architecture und ihr Design.

Beziehungen#

• ◆KNOWLEDGE-REFERENCE-MODELOrdnet Wissensartefakte, Wissensbeziehungen, fachliche Heimat, Scope und Sprachfassungen universell ein. — uses
• ◆RP-KNOWLEDGE-EVOLUTIONLebenszyklus von Beobachtung und Evidence über Konsolidierung bis zur institutionalisierten Erkenntnis. — uses