GitHub

In LaunchCal, un lancio può seguire il suo lavoro in GitHub: un progetto di un'organizzazione o una milestone di un repository. Il suo stato cambia quando cambia quello del progetto o della milestone, ne mostra l'avanzamento, e gli aggiornamenti di stato di un progetto compaiono sul lancio.

Taktoria si limita a leggere da GitHub: non vi crea, modifica o commenta mai nulla. È collegato come app installata nella tua organizzazione e non come persona, quindi vede solo i repository scelti dall'organizzazione e continua a funzionare chiunque l'abbia collegato.

Solo un proprietario o un amministratore dello spazio di lavoro può collegare GitHub.

1. Apri Impostazioni → Integrazioni.
2. Sotto Sistemi di ticketing, seleziona Collega GitHub.
3. In GitHub, installa l'app Taktoria nell'organizzazione, scegli quali repository può leggere, e approva.

L'app chiede di leggere i progetti dell'organizzazione, e le issue, le pull request e i metadati dei suoi repository. Se un proprietario dell'organizzazione deve prima approvarla, Taktoria lo segnala: seleziona di nuovo Collega GitHub dopo che l'ha fatto. La scheda dice poi a quale organizzazione è collegato. Ogni spazio di lavoro Taktoria ne collega una.

Chiunque possa modificare un lancio può associarlo, sincronizzarlo o dissociarlo.

1. Apri la scheda Dettagli del lancio.
2. Sotto Progetto di ticketing, incolla in Link del progetto l'indirizzo del progetto dell'organizzazione o della milestone del repository.
3. Seleziona Associa progetto.

Un progetto deve appartenere all'organizzazione collegata, e una milestone a un repository che l'app può leggere. Si sincronizza subito. Un repository, o qualsiasi altra cosa in GitHub, resta un semplice link, come un link incollato prima che GitHub sia collegato, finché non lo è.

Anche un assistente IA collegato a LaunchCal e l'API REST possono associare, sincronizzare e dissociare un lancio, con le stesse regole.

Un lancio associato viene sincronizzato una volta al giorno fino al lancio, e ogni volta che qualcuno seleziona Sincronizza ora.

Per un progetto:

• Stato: lo dice l'aggiornamento di stato più recente del progetto. In linea, a rischio o fuori strada diventa In sviluppo (un lancio già in Design o Test resta lì), inattivo diventa In pausa, e completato significa finito. Senza ancora aggiornamenti di stato, il lancio resta in Definizione finché uno degli elementi del progetto non è completato. Un progetto chiuso è finito, a meno che non fosse inattivo.
• Avanzamento: la quota dei suoi elementi chiusi, uniti o in una colonna di completati.
• Aggiornamenti di stato: ognuno diventa un aggiornamento del lancio nella sua scheda Attività, contrassegnato Da GitHub con un link all'originale, e la salute del lancio segue il più recente.

Per una milestone: aperta senza issue chiuse è Definizione, aperta con alcune chiuse è In sviluppo, e chiusa significa finita. Il suo avanzamento è la quota delle sue issue chiuse. Una milestone non ha aggiornamenti.

Quando il progetto o la milestone è finito, il lancio indica che è pronto e i suoi responsabili vengono avvisati. Uno stato che scegli in LaunchCal resta finché quello di GitHub non cambia di nuovo. Ciò che una sincronizzazione modifica risulta fatto da GitHub, nella cronologia del lancio, in ciò che viene inviato ai suoi responsabili e nel registro di audit.

• Non lancia mai nulla. Un progetto o una milestone finiti rendono il lancio pronto; qualcuno deve comunque selezionare Premi per lanciare! quando le sue revisioni obbligatorie sono decise.
• Non modifica mai un lancio già lanciato.
• Non scrive mai in GitHub.
• Non legge mai un repository che l'organizzazione non le ha concesso.

Dissocia, nella scheda Dettagli del lancio, interrompe la sincronizzazione di quel lancio; ciò che è stato importato resta.

Scollega, in Impostazioni → Integrazioni, interrompe la sincronizzazione di tutti i lanci da GitHub e revoca subito l'accesso di Taktoria. I lanci mantengono ciò a cui sono associati e tutto ciò che è stato sincronizzato fin lì, e riprendono non appena GitHub viene ricollegato. L'app resta installata nell'organizzazione finché uno dei suoi proprietari non la disinstalla dalle impostazioni dell'organizzazione su GitHub.

• Impossibile trovare il progetto: è stato eliminato, o si trova dove l'app non può vederlo, come un repository che l'organizzazione non le ha concesso. Un proprietario dell'organizzazione può aggiungere il repository all'accesso dell'app nelle sue impostazioni su GitHub; oppure associa l'indirizzo attuale.
• GitHub ha rifiutato il collegamento: l'app è stata disinstallata o sospesa. Un proprietario o un amministratore dello spazio di lavoro ricollega GitHub in Impostazioni → Integrazioni.
• L'app è in attesa di approvazione: un proprietario dell'organizzazione la approva su GitHub, poi seleziona di nuovo Collega GitHub.
• GitHub non ha risposto all'ultima sincronizzazione: la prossima riproverà, oppure seleziona Sincronizza ora più tardi.
• Resta un semplice link: GitHub non è ancora collegato, o l'indirizzo non è quello di un progetto di un'organizzazione né di una milestone.