Semantik für Label

[suchja]

Um GitHub's Issues in einer strukturierten Art und Weise zu verwenden, sind Labels genial. GitHub überlässt es komplett dem Benutzer wie er seinen Workflow strukturiert. Das bedeutet einerseits Freiheit und andererseits wird es schnell unübersichtlich. Mir geht das schon so bei den paar Issues die ich bisher für dieses Projekt erstellt habe. Daher werde ich erstmal ein paar grundlegende Labels definieren.

Welche sind wichtig?

[suchja]

Hier gibt es eine erste Definition: https://robinpowered.com/blog/best-practice-system-for-organizing-and-tagging-github-issues/ Dazu dieses Beispiel wie die Labels in einem Projekt verwendet werden: https://github.com/robinpowered/swolebot/labels

Ist für DailyGitHub so noch nicht anwendbar.

[suchja]

Was will ich erreichen?

• Ich will schnell ein Issue finden an dem ich jetzt arbeiten kann.
  • Da ich häufig nur ein paar Minuten Zeit habe, wäre es gut eine erste Einschätzung des Aufwands zu haben.
  • Ich habe nicht immer alles Equipment zur Verfügung. Wenn ich unterwegs bin, kann ich zum Beispiel schlecht ein Video drehen.
• Ich setze die Issues auch für meine Aufgabenplanung ein. Daher möchte ich sehen können bei welchen Issues ich etwas umsetzen muss. Es geht also um die Art des Issues.

[suchja]

Sehr guter Überblick wie Labels bei Saltstack erstellt werden. Ist schon ein umfangreiche Organisation und wahrscheinlich wird bei denen intern ein einigermaßen komplexer Workflow verwendet: https://docs.saltstack.com/en/latest/topics/development/labels.html

Mir gefallen besonders gut:

• Type das würde hier der Art am besten entsprechen.
• Priority wobei ich P1 bis P4 nicht so toll finde.
• Functional Area wäre hier so etwas wie "Bereich"
• Type of Change da ist dann der Aufwand. Cool finde ich die Definition der einzelnen Aufwände. Das kann ich hier allerdings so nicht so gut umsetzen.

[suchja]

Damit komme ich zu folgender Definition:

Art - Ein Issue kann auch mehrere Arten haben

• Aufgabe - zeigt das jemand etwas zutun hat
• Diskussion - Eine Frage, Idee, Meinung die von außen oder von mir erstellt wird und dann diskutiert wird.
• Feedback - Rückmeldung (Lob oder Kritik) zu Aktivitäten rund um DailyGitHub

Bereich - Ein Issue sollte möglichst nur einem Bereich zugeordnet sein. Das bringt den Vorteil, dass mehr kleine Issues erstellt werden, die dann wieder schnellt bearbeitet werden.

• DGH-Show - Hauptsächlich Ideen und Input für die DailyGitHub-Show
• Repository - Änderungen, Feedback, ... die an diesem GitHub-Verzeichnis durch geführt werden sollen.
• Social Media- Alles was für YouTube, Twitter, ... getan werden muss

Priorität - Wie schnell muss es umgesetzt werden? Es darf nur ein Label aus dieser Kategorie pro Issue verwendet werden. Hauptsächlich relevant für Issues der Art Aufgabe.

• Hoch -
• Mittel -
• Niedrig -

Aufwand - Wie lange wird es dauern dieses Issue zu lösen? (Momentan sehr subjektiv!)

• Minuten - Etwas, dass ich wahrscheinlich innerhalb von 30 Minuten oder weniger lösen kann.
• Stunden - Etwas, dass maximal 3-4h dauert
• Tage - Alles was mehr als 4h dauert

[suchja]

Labels entsprechend der Definition angelegt und bestehende Issues zugewiesen