Notes

Die Notes dienen als Arbeitsbereich für Ideen, Beobachtungen, Evaluierungen und Erkenntnisse.

Im Gegensatz zu ADRs stellen Inhalte in diesem Bereich keine verbindlichen Architekturentscheidungen dar.

Zweck

Hier werden Informationen gesammelt, die:

  • Noch nicht ausreichend bewertet wurden

  • Weitere Analyse benötigen

  • Zukünftige Änderungen betreffen

  • Aus Betriebserfahrungen entstanden sind

  • Mögliche Architekturänderungen beschreiben

Inhalte

Typische Inhalte:

  • Hardware Roadmaps

  • Evaluierungen neuer Technologien

  • Lessons Learned

  • Erkenntnisse aus Incidents

  • Research Ergebnisse

  • Optimierungsansätze

  • Offene Fragen

Abgrenzung

Notes

Beschreiben:

  • Ideen

  • Beobachtungen

  • Hypothesen

  • Evaluierungen

Beispiel:

Enterprise SSDs für LINSTOR evaluieren

ADRs

Beschreiben:

  • Getroffene Entscheidungen

  • Architekturänderungen

  • Verbindliche Standards

Beispiel:

ADR-007: Nutzung von Piraeus Datastore

Runbooks

Beschreiben:

  • Wiederholbare Prozesse

  • Operative Tätigkeiten

  • Schritt-für-Schritt-Anleitungen

Beispiel:

StorageClass Migration

Workflow

Typischer Ablauf:

Idee
  |
  v
Note
  |
  v
Evaluierung
  |
  +--> Verworfen
  |
  +--> Runbook
  |
  +--> ADR
  |
  +--> Architektur-Dokumentation

Nicht jede Note führt zu einer Änderung der Plattform.

Richtlinien

  • Keine Architekturentscheidungen dokumentieren

  • Keine Runbooks pflegen

  • Keine Betriebsanleitungen ablegen

  • Erkenntnisse möglichst nachvollziehbar dokumentieren

  • Quellen und Referenzen festhalten

Der Bereich darf bewusst unvollständig sein und dient als Arbeits- und Wissensspeicher.