GitHub

In LaunchCal kan een lancering haar werk in GitHub volgen: een project van een organisatie, of een mijlpaal van een repository. Haar status verandert als die van het project of de mijlpaal verandert, ze toont de voortgang ervan, en de statusupdates van een project verschijnen bij de lancering.

Taktoria leest alleen uit GitHub: het maakt daar nooit iets aan, wijzigt niets en plaatst geen opmerkingen. Het is gekoppeld als app die in je organisatie is geïnstalleerd en niet als persoon, dus het ziet alleen de repositories die de organisatie heeft gekozen, en het blijft werken, wie het ook heeft gekoppeld.

Alleen een eigenaar of beheerder van de workspace kan GitHub koppelen.

1. Open Instellingen → Integraties.
2. Kies onder Ticketsystemen de optie GitHub koppelen.
3. Installeer op GitHub de Taktoria-app in de organisatie, kies welke repositories ze mag lezen, en keur het goed.

De app vraagt om de projecten van de organisatie te lezen, en de issues, pull requests en metadata van de repositories. Moet een eigenaar van de organisatie haar eerst goedkeuren, dan meldt Taktoria dat: kies opnieuw GitHub koppelen zodra dat gebeurd is. De kaart zegt dan aan welke organisatie hij gekoppeld is. Elke Taktoria-workspace koppelt er één.

Iedereen die een lancering kan bewerken, kan haar linken, synchroniseren of de link verwijderen.

1. Open het tabblad Details van de lancering.
2. Plak onder Ticketproject het adres van het project van de organisatie, of van de mijlpaal van de repository, in Projectlink.
3. Kies Project linken.

Een project moet van de gekoppelde organisatie zijn, en een mijlpaal moet in een repository staan die de app mag lezen. Het synchroniseert meteen. Een repository, of iets anders in GitHub, blijft een gewone link, net als een link die is geplakt voordat GitHub gekoppeld was, tot het dat is.

Een AI-assistent die aan LaunchCal is gekoppeld, en de REST API, kunnen een lancering ook linken, synchroniseren en de link verwijderen, volgens dezelfde regels.

Een gelinkte lancering wordt eenmaal per dag gesynchroniseerd tot ze gelanceerd is, en telkens wanneer iemand Nu synchroniseren kiest.

Voor een project:

• Status: de nieuwste statusupdate van het project bepaalt die. Op schema, risico of achter op schema wordt In ontwikkeling (een lancering die al in Ontwerp of Testen staat, blijft daar), inactief wordt Gepauzeerd, en voltooid is af. Zonder statusupdate blijft de lancering op Afbakening tot een van de items van het project af is. Een gesloten project is af, tenzij het inactief was.
• Voortgang: het aandeel van de items dat gesloten of gemerged is, of in een kolom voor afgerond werk staat.
• Statusupdates: elke statusupdate wordt een update van de lancering op het tabblad Activiteit, gemarkeerd met Uit GitHub en een link ernaartoe, en de gezondheid van de lancering volgt de nieuwste.

Voor een mijlpaal: open zonder gesloten issues is Afbakening, open met enkele gesloten issues is In ontwikkeling, en gesloten is af. De voortgang is het aandeel gesloten issues. Een mijlpaal heeft geen updates.

Als het project of de mijlpaal af is, meldt de lancering dat ze klaar is en horen de eigenaren het. Een status die je in LaunchCal kiest, blijft staan tot die in GitHub weer verandert. Wat een synchronisatie wijzigt, staat op naam van GitHub, in de geschiedenis van de lancering, in wat de eigenaren ontvangen en in het auditlogboek.

• Het lanceert nooit iets. Een afgerond project of een afgeronde mijlpaal maakt de lancering klaar; iemand kiest nog steeds zelf Druk om te lanceren! zodra over de verplichte beoordelingen is besloten.
• Het wijzigt nooit een lancering die al gelanceerd is.
• Het schrijft nooit naar GitHub.
• Het leest nooit een repository die de organisatie het niet heeft gegeven.

Link verwijderen, op het tabblad Details van de lancering, stopt het synchroniseren van die lancering; wat al binnengehaald is, blijft.

Ontkoppelen, in Instellingen → Integraties, stopt het synchroniseren van alle lanceringen vanuit GitHub en beëindigt de toegang van Taktoria meteen. Lanceringen houden wat ze linken en alles wat tot dan toe is gesynchroniseerd, en gaan verder zodra GitHub weer gekoppeld is. De app blijft in de organisatie geïnstalleerd tot een van de eigenaren haar verwijdert in de instellingen van de organisatie op GitHub.

• Het project is niet gevonden: het is verwijderd, of het staat ergens waar de app niet bij kan, zoals een repository die de organisatie haar niet gaf. Een eigenaar van de organisatie kan de repository toevoegen aan de toegang van de app in de instellingen ervan op GitHub; of link het huidige adres.
• GitHub heeft de koppeling geweigerd: de app is verwijderd of opgeschort. Een eigenaar of beheerder van de workspace koppelt GitHub opnieuw in Instellingen → Integraties.
• De app wacht op goedkeuring: een eigenaar van de organisatie keurt haar goed op GitHub; kies daarna opnieuw GitHub koppelen.
• GitHub gaf geen antwoord bij de laatste synchronisatie: de volgende synchronisatie probeert het opnieuw, of kies later Nu synchroniseren.
• Het blijft een gewone link: GitHub is nog niet gekoppeld, of het adres is niet dat van een project van een organisatie of van een mijlpaal.