LEARNING-NUGGET-CONTRACT

Learning-Nugget-Vertrag#

Zweck#

Ein ⌘Learning NuggetDidaktisches Wissensartefakt, das ein Architektur- oder Technikthema verständlich erklärt, ohne normative Architekturregeln zu ersetzen. ist ein eigenständiges, didaktisches Wissensartefakt. Es erklärt genau eine fachliche oder technische Fragestellung verständlich, anschaulich und praxisnah und schließt damit die Lücke zwischen normativer Architektur und kurzer Begriffsdefinition.

Verbindliche Verantwortung#

Ein Learning Nugget:

• erläutert genau eine abgegrenzte Fragestellung;
• darf Analogien, Beispiele und vereinfachte Herleitungen verwenden;
• verweist auf die maßgeblichen Concepts, Decisions, Glossary Entries und ergänzenden Artefakte;
• ist keine normative Architekturquelle und ersetzt keine Definition oder Entscheidung;
• verändert keine Fakten, Entscheidungen oder fachlichen Definitionen;
• benennt Grenzen, Vereinfachungen und mögliche Missverständnisse;
• besitzt stabile, universumsweit eindeutige Artefaktidentität, Owner, Status und Version.

Auslöser: Erkenntnis zu Learning Nugget#

Ein Nugget entsteht erst, wenn eine Erkenntnis validiert, mit bestehenden Quellen konsolidiert und einer fachlichen Heimat sowie Gültigkeitsebene zugeordnet ist. Beobachtung, ⌘FindingTechnical documentation artifact., Analyse oder ⌘EvidenceTechnical documentation artifact. allein lösen keine automatische ⌘PromotionTechnical documentation artifact. aus.

Die Promotion folgt dem ◆Knowledge Evolution ProcessLebenszyklus von Beobachtung und Evidence über Konsolidierung bis zur institutionalisierten Erkenntnis.:

Observation → Finding → Analysis → Decision or Rule → Implementation
                → Verification → Evidence → Consolidation and Scope Classification
                → Learning Nugget

Das Nugget trägt nur auf der höchsten Ebene, die durch Quellen und Evidence gedeckt ist. Solution- oder Engineering-Erkenntnisse werden nicht allein durch Ablage im Enterprise-Repository universell.

Verbindliche Struktur#

1. Thema – präzise Frage oder klar abgegrenzte Aussage.
2. Das Problem – Verständnisproblem, typische Fehlannahme oder praktische Schwierigkeit.
3. Anschauliches Bild – Analogie, Beispiel oder Szenario, das die normative Architektur nicht verfälscht.
4. ⌘BedeutungBedeutung beschreibt den fachlichen Sinn eines Elements und seine Relevanz für Menschen und Organisationen. für die jeweilige Solution oder Plattform – Relevanz im konkreten Nutzungskontext; die Überschrift wird passend spezialisiert.
5. Grenzen – Gültigkeitsgrenze, Vereinfachung und zu vermeidende Missverständnisse.
6. Weiterführende Artefakte – normative und ergänzende Concepts, Glossary Entries, Decisions, Patterns und verwandte Nuggets.

Eine Kurzfassung oder ein Merksatz vor dem Problem ist optional.

Qualitätskriterien#

Ein Nugget ist ausreichend ausgearbeitet, wenn es genau eine Fragestellung behandelt, Problem und Bedeutung trennt, kein irreführendes Bild verwendet, Grenzen ausdrücklich nennt, normative Aussagen auf führende Artefakte zurückführt und ohne Kenntnis des Entstehungschats verständlich ist.

Abgrenzung#

• Glossary Entry: kurze verbindliche Begriffsdefinition.
• Learning Nugget: didaktische Erklärung und Einordnung.
• Concept: normative Architektur.
• ADR oder Decision: dokumentierte Entscheidung.
• Knowledge Story: konkrete Erfahrung als Wissensquelle.
• Pattern: wiederverwendbare bewährte Lösung.

Darstellung und Auflösung#

Learning Nuggets dürfen sichtbar hervorgehoben werden. Auswahl und Auflösung erfolgen vor der Darstellung. ⌘RendererEin Renderer erzeugt eine konkrete technische Ausgabeform aus einer vorbereiteten Dokumentationsprojektion. Beispiele sind HTML, PDF, Markdown, JSON oder ein Suchindex. zeigen nur vorbereitete Annotationen. Eine Referenz ist vom Glossar unterscheidbar; Hover oder Tastaturfokus kann eine Kurzfassung, Klick oder Enter eine kompakte Erklärung und erst ein bewusster Link das vollständige Nugget öffnen. Keine dieser Sichten ersetzt das eigenständige ⌘ArtefaktEin Artefakt ist jede eindeutig identifizierbare fachliche, technische, organisatorische oder reale Einheit, die in der Engineering-Landschaft modelliert wird..

Beziehungen#

• ◆LEARNING-NUGGET-TEMPLATEKanonische Struktur eines Learning Nuggets nach dem übernommenen Legacy-Vertrag. — verwendet diese kanonische Struktur
• ◆RP-KNOWLEDGE-EVOLUTIONLebenszyklus von Beobachtung und Evidence über Konsolidierung bis zur institutionalisierten Erkenntnis. — folgt dem Wissensevolutionsprozess
• ◆EA-SEMANTICS-EKEL-001Ordnet Explainability, Knowledge, Evidence und Learning als zusammenhängende, aber getrennt verantwortete Wissensstruktur ein. — leitet sich aus Explainability, Knowledge, Evidence and Learning ab