NUG-0007-WARUM-TODO-UND-REVIEW-KEINE-LINKS-SIND

Warum Todo und Review keine Links sind#

Übersicht · 2: zweite Ebene · Ziehen/Klicken: navigieren

Kurzfassung#

Eine Artefaktreferenz sagt: „Dieses andere Artefakt ist gemeint.“ Eine Todo- oder Review-Annotation sagt: „An dieser Stelle ist Arbeit nötig.“ Beide verwenden sichtbare Marker, erfüllen aber völlig unterschiedliche Aufgaben.

Anschauliches Bild#

Eine Artefaktreferenz ist wie eine Adresse auf einem Wegweiser. Eine Processing Annotation ist wie ein gelber Klebezettel direkt auf dem Dokument. Der Klebezettel braucht kein Ziel im Katalog.

Bedeutung für die Engineering-Landschaft#

Der Processing Layer trennt beide Konstrukte vor der Validierung. Dadurch entstehen keine falschen Broken Links, und HTML kann lokale Arbeitsaufträge trotzdem deutlich sichtbar darstellen.

Weiterführende Artefakte#

CON-022-DOCUMENTATION-PROCESSING-ANNOTATIONS
ART-DEF-0036
ART-DEF-0037
ART-DEF-0038

Migrationsherkunft#

Dieses Learning Nugget wurde aus SolutionArchitecture:85-knowledge/20-learning-nuggets/NUG-0007-WARUM-TODO-UND-REVIEW-KEINE-LINKS-SIND.md für die Enterprise-Ebene konsolidiert. Historische Contract-, ADR- und Glossarreferenzen bleiben als Provenienz sichtbar; sie werden nicht als aktuelle Enterprise-Definitionen interpretiert.

Beziehungen#

LEARNING-NUGGET-CONTRACT — folgt diesem Vertrag