Projektledare
Release notes ur commitloggen, inte ur minnet klockan 17.45
Läser allt sedan den förra release-taggen, skiljer funktioner från fixar från brus och lämnar ett kundfärdigt utkast på ditt arbetsbord att redigera.
Release notes skrivs vid sämsta tänkbara tillfälle, precis före releasen, ur minnet. Det är så funktionen som tog tre veckor gick ut utan ett ord och changelog-raden lyder ”diverse förbättringar”.
Så fungerar det
- 01
Klona repot till agentens arbetsyta en gång. När det är dags för release notes, schemalagt eller på begäran, hämtar den, listar varje commit sedan föregående release-tagg och sorterar dem: funktioner, fixar och interna ändringar som en kund aldrig behöver höra om. Knapphändiga commit-meddelanden skrivs om till meningar en kund kan göra något med, bruset plockas bort, och allt den inte kan klassificera med säkerhet flaggas för ditt avgörande i stället för att gissas fram.
- 02
Utkastet landar som ett dokument på arbetsbordet, och ett Slack-meddelande pekar ut precis de punkter som kräver mänskligt omdöme. Timmen av att skrolla historik blir en femminutersgranskning, vilket ungefär är skillnaden mellan att release notes finns och att de inte gör det.