Entwickler Handbuch

Git Konventionen

Wir nutzen Conventional Commit Messages: https://www.conventionalcommits.org/

Die Sprache der Commits ist Englisch.

Dokumentation von Architektur-Änderungen

Alle Änderungen und Änderungswünsche, die sich nicht nur auf die neu entwickelte Funktion, sondern auf die gesamte Datenfabrik auswirken, müssen vor ihrer Umsetzung dokumentiert werden.

Im Zweifelsfall sollte mit dem Datenfabrik-Team besprochen werden, ob die Änderung zu umfangreich ist, um sie einfach „durchzuziehen“. Dazu wird ein „Architectural Decision Record“ genutzt, mit diesem dokumentieren wir die Änderung/den Änderungswunsch, notwendig sind folgende Informationen:

• Formulierung einer Ziel- bzw. Problemstellung
• Abstimmung mit allen betroffenen Interessengruppen
• Auswahl zwischen mehreren Optionen (mindestens: Beibehaltung des Status quo / Anwendung eines neuen Ansatzes) Festlegung (gewichteter) Kriterien, anhand derer diese Änderung bewertet werden soll
• Einholung von Input/Ratschlägen von 1–2 weiteren Personen, die a) über Fachwissen in diesem Entscheidungsbereich verfügen oder b) von der Änderung betroffen sind
• Dokumentation des Ergebnisses als separate WIKI-Seite