V. Zusammenarbeit und Kommunikation
In der Softwareentwicklung sind effektive Zusammenarbeit und Kommunikation ebenso wichtig wie das Schreiben von gutem Code. Diese Aspekte sind entscheidend, um sicherzustellen, dass alle im Team auf demselben Stand sind, dass Aufgaben richtig verstanden und effektiv ausgeführt werden und dass etwaige Probleme oder Herausforderungen zeitnah erkannt und gelöst werden. Dieser Abschnitt der Richtlinien beschreibt unsere Praktiken und Erwartungen rund um die Verwendung von Kommunikationswerkzeugen, die Zusammenarbeit mit internen Teams sowie die Meldung und Nachverfolgung von Problemen.
A. Effektive Nutzung von Kommunikationswerkzeugen
Wir verwenden eine Vielzahl von Kommunikationswerkzeugen, um eine effektive Zusammenarbeit innerhalb unserer Teams zu ermöglichen. Dazu gehören Microsoft Teams, Wikis, Markdown-Dateien und GitHub Issues.
Microsoft Teams ist unser primäres Werkzeug für direkte und sofortige Kommunikation. Es kann für schnelle Diskussionen mit einzelnen Teammitgliedern oder ganzen Teams genutzt werden. Es ist jedoch wichtig zu beachten, dass Entscheidungen, die während Teams-Anrufen oder über private Nachrichten getroffen werden, möglicherweise nicht für alle Teammitglieder transparent sind. Daher sollten alle kritischen Entscheidungen angemessen mit unseren anderen Werkzeugen dokumentiert werden.
Wikis dienen als Ablage für architektonische Erkenntnisse und übergeordnete Informationen über unser System oder seine Komponenten. Sie sind ein hervorragender Ort, um Informationen zu speichern, die ein breiteres Verständnis unserer Projekte vermitteln.
Markdown-Dateien werden typischerweise für spezifischere Informationen über einen bestimmten Dienst oder eine interne Bibliothek verwendet. Sie können notwendige Details erfassen, die für einen bestimmten Kontext oder Teil des Systems relevant sind.
Azure Devops Issues werden verwendet, um Fehler, Feature-Anfragen und andere projektbezogene Aufgaben zu verfolgen. Selbst wenn diese nicht sofort bearbeitet werden, stellt das Protokollieren als Issue sicher, dass wir den Überblick nicht verlieren. Bevor Sie ein neues Issue anlegen, ist es wichtig, die bestehenden Issues zu durchsuchen, um Duplikate zu vermeiden. Dieser Ansatz hilft uns, eine gut dokumentierte, durchsuchbare Aufzeichnung aller projektbezogenen Diskussionen und Entscheidungen zu führen.
B. Meldung und Nachverfolgung von Problemen
Azure Devops Issues ist unser primäres Werkzeug zur Nachverfolgung aller projektbezogenen Aufgaben, zu denen neue Features, Fehlerbehebungen, Sicherheitsprobleme und mehr gehören können. Beim Anlegen eines neuen Issues ist es entscheidend, so viele relevante Informationen wie möglich anzugeben, um das Verständnis und die Lösung zu erleichtern.
Für Fehlerberichte: Geben Sie die Softwareversion an, in der der Fehler gefunden wurde, und beschreiben Sie die Umgebung, in der er entdeckt wurde (z. B. Kubernetes-Version). Fügen Sie nach Möglichkeit relevante Protokolldateien oder Screenshots bei, die bei der Diagnose des Problems helfen könnten.
Für Feature-Anfragen: Formulieren Sie klar die Vorteile, die das vorgeschlagene Feature bringen würde. Beschreiben Sie die Probleme, die es lösen würde, und wie es bestimmte Vorgänge oder Funktionen vereinfachen oder ermöglichen könnte.
Bevor Sie ein neues Issue anlegen, durchsuchen Sie stets die bestehenden Issues, um Duplikate zu vermeiden. In Situationen, in denen ein Issue einen bestimmten Fachbereich betrifft, zögern Sie nicht, mit Kolleginnen und Kollegen zusammenzuarbeiten oder diese zu erwähnen, die Expertinnen und Experten auf diesem Gebiet sind. Sie können wertvolle Erkenntnisse einbringen und den Lösungsprozess beschleunigen. So bleibt unser Issue-Tracker ein effektives und effizientes Werkzeug für das Projektmanagement.