Ärenden, etiketter och teamsamarbete

Bra ärendehantering ger tillräckligt med information för att förstå vad som är fel eller saknas, hur ett godkänt resultat ser ut och vem som ansvarar. Den ersätter inte arkitekturdiskussioner eller kodgranskning. GitHub Issues bevarar diskussion och länkar till förändringar, medan GitHub Projects visar ärendena i olika planeringsvyer.

Skriv tydliga ärenden

En användbar rubrik beskriver ett konkret resultat, till exempel Inventory items duplicate after reconnect, snarare än bara Inventory. Lägg till reproduktionssteg, faktiskt och förväntat beteende, miljö, allvarlighetsgrad, acceptanskriterier och relevanta loggar. Ta bort hemligheter och personuppgifter innan du delar utdrag.

För funktioner anger du ett begränsat omfång som kan testas. Ärenden som tar veckor kan delas i sub-issues, där varje del får eget ansvar och egen granskning. En Markdown-checklista räcker för små kontrollpunkter inom samma ärende, men är inte samma sak som separat spårade delärenden.

Etiketter, milstolpar och fält

Verktyg	Vad det används till	Exempel
Label	Kategorisering	bug, documentation, needs-repro
Milestone	Release eller samlad leverans	v1.3
Assignee	Ansvarig person	@reviewer
Sub-issue	Självständigt spårbar del	Build inventory UI
Project field	Planeringsdimension	Status eller Priority

Använd ett konsekvent och begränsat antal etiketter. Om allt kallas akut blir prioriteringen meningslös. Skilj också organisationens issue-fält från projektets egna fält där båda används.

Kommunikation med Markdown

Rubriker, listor, kodblock, tabeller och checkboxar gör tekniska diskussioner tydligare. Omnämnanden kan skicka aviseringar och bör användas sparsamt. GitHub kan länka ärenden med #42, och vissa nyckelord i en pull request kan stänga kopplade ärenden när den mergas till standardgrenen.

Issue forms och mallar kan samla förväntad information. En pull-request-mall kan påminna om tester, risker och rollback. En mall ersätter aldrig en verklig förklaring.

Behörigheter och ansvar

Tilldela åtkomst enligt minsta privilegium och skydda viktiga grenar på plattformen. Projektmedlemskap är inte samma sak som repositoryåtkomst. Granska kod och beteende, inte personen som skrev den. Bevara viktiga beslut i ärendet eller pull requesten, inte enbart i en privat chatt.

Ett fungerande flöde är prioritera → tilldela → skapa gren → implementera → granska → testa → leverera → avsluta eller följ upp. Se från ärende till release för ett sammanhängande exempel.

Referenser: GitHub issues, GitHub Projects.