git/vereinbarungen.md

19 lines
3.3 KiB
Markdown
Raw Permalink Normal View History

2024-07-15 13:01:25 +00:00
# Vereinbarungen zur Zusammenarbeit mit Git
Hier werden Vereinbarungen und Absprachen für die gemeinsame offene und effektive Zusammenarbeit mit Git festgehalten.
## Netiquette
**Du-Ermutigung:** Für die offene Zusammenarbeit braucht es ein respektvolles Miteinander und flache Hierarchien. Daher möchten wir dazu einladen, euch grundsätzlich zu duzen. Teamintern können natürlich auch andere Absprachen getroffen werden.
**Fehlerkultur:** Wir verstehen uns als lernende Organisation und möchten zum freien Ausprobieren und zum eigenständigen Machen einladen ohne Angst davor, etwas falsch zu machen. Vermeintliche Fehler und Irrtümer gehören dazu und helfen uns dabei, unsere Arbeitsabläufe und -prozesse zu verbessern.An vielen Stellen gibt es kein richtig oder falsch, sondern verschiedene Wege und Lösungen. Lasst uns gemeinsam Fehler machen und beheben und schauen, welche Arbeitsweisen sich für uns als praktikabel erweisen.
2024-07-15 17:05:06 +00:00
**Datenschutz:** Wir befinden uns im öffentlichen Raum: vertrauliche Absprachen und Informationen, Zugangsdaten oder persönliche Daten wie Namen, Adressen, Telefonnr. etc. müssen geschützt werden und dürfen hier nicht veröffentlicht werden!
2024-07-15 13:01:25 +00:00
2024-07-15 17:05:06 +00:00
**Selbstbestimmung statt Fremdzuweisung:** Personen können sich selbst als Zuständige zuweisen und entscheiden, ob sie ein Issue bearbeiten wollen oder nicht. Alternativ können in Issues durch @-Markierungen konkrete Personen in den Kommentaren angesprochen werden, die das Issue übernehmen oder unterstützen könnten. Diese können dann selbst entscheiden, ob sie sich dem Issue annehmen. Zuständigkeiten können auch teamintern besprochen und verteilt werden, bevor sie in Issues festgelegt werden. Damit nicht eine Person alle möglichen Issues zugewiesen bekommt, ohne die Kapazitäten zu haben, sollte die betreffende Person vorher gefragt werden, ob sie das Issue übernehmen möchte. Zuständige ohne vorherige Absprache festzulegen könnte als übergriffig empfunden wird. Deshalb verständigen wir uns darauf, Issues immer zu nehmen statt zu geben.
2024-07-15 13:01:25 +00:00
**Nachvollziehbarkeit:** Durch Git sollen Arbeitsschritte transparent und für andere nachvollziehbar gemacht werden. Dazu ist es wichtig, dass Titel, Beschreibungen oder auch die Bezeichnungen bzw Zuordnungen von Labels etc. so präzise sind, dass auch andere, die nicht direkt involviert sind, verstehen, was gemeint ist. Insbesondere in Issues sollten Aufgaben so formuliert sein, dass deutlich wird, wer was bis wann zu tun hat.
**Feedbackkultur:** Damit Arbeitsprozesse vorankommen, Inhalte weiterentwickelt oder Fragen beantwortet werden können, braucht es euer Feedback. Bitte beachtet, dass eure Rückmeldungen gerne offen und direkt, aber immer konstruktiv sind.
**Reviewverfahren:** Mitarbeit ist erlaubt und ausdrücklich erwünscht! Dennoch hat es vermutlich niemand gerne, wenn andere einfach die Inhalte verändern. Aus Respekt möchten wir daher nahelegen, einen eigenen Branch für die Änderungen anzulegen und dann einen Pull Reuqest zu erstellen (siehe Dok zu Branch + PR -> muss noch erstellt werden). Das erscheint zwar umständlich zu sein, ist aber eine Wertschätzung gegenüber der Urheberin / des Urhebers, da sie/er dann entscheiden kann, ob die Änderungen angenommen werden sollen oder nicht und nicht vor vollendete Tatsachen gesetzt wird oder die Änderungen rückgängig machen muss.