Collega GitHub

La connessione di Notion con GitHub ti consente di collegare senza problemi i tuoi workflow di sviluppo. Puoi collegare i contenuti di GitHub direttamente nelle pagine Notion, pull informazioni di GitHub nei database Notion e sincronizzare le pull request con le attività di Notion per mantenere il tuo team informato sullo stato dei progetti. Continua a leggere per scoprire le diverse funzionalità della connessione e come configurarle.

Devi essere sia proprietario dello spazio di lavoro Notion che amministratore dell'organizzazione GitHub per collegare Notion e l'app GitHub per lo spazio di lavoro.

1. Vai su Impostazioni nella barra laterale → Connessioni.

2. Trova GitHub (Spazio di lavoro).

3. Fai clic su Collega e segui la procedura di autenticazione.

Collega un link a un file o a righe specifiche di un file direttamente in Notion. Puoi persino collegare da un commit o un branch specifico se vuoi che il codice a cui fai riferimento sia aggiornato.

1. Copia il permalink delle righe desiderate da GitHub.

2. Incollalo in una pagina Notion e seleziona Incolla come anteprima per incorporare il codice nella tua pagina.

Puoi sincronizzare i tuoi repository GitHub (inclusi pull request e issue) in Notion come database. Per farlo:

1. In GitHub, copia il link a una pull request o a una issue.

2. Incolla il link in Notion e seleziona Incolla come database.

   • Se non l'hai già fatto, ti verrà chiesto di accedere e collegare Notion al tuo account GitHub.

3. Il database sincronizzato verrà creato in una vista tabella, con tutte le proprietà di GitHub aggiunte automaticamente.

4. Il database inizierà a popolarsi automaticamente e continuerà a sincronizzarsi anche se lasci la pagina.

Ecco un elenco delle proprietà di GitHub che supportiamo:

Le etichette e i tag non sono supportati al momento.

Puoi utilizzare il mapping delle identità per collegare le identità GitHub ai profili di Notion del tuo team. Per farlo:

1. Vai alle tue GitHub email settings e assicurati che l'impostazione Keep my email addresses private non sia attivata, in modo da mantenere le email impostate come privato.

2. Nel tuo profilo GitHub (https://github.com/{YOUR_USERNAME_HERE}), modifica il tuo profilo per aggiungere il tuo indirizzo email di Notion.

Questo consente di mappare la tua identità ai database sincronizzati negli spazi di lavoro di cui sei membro.

La proprietà GitHub Pull Request all'interno del tuo database Notion manterrà automaticamente informati i tuoi team interfunzionali sullo stato delle attività. Dispone inoltre di molti attributi che puoi utilizzare in rollup, formule e filtri.

1. In un database Notion, fai clic su + per aggiungere una nuova proprietà.

2. Cerca e fai clic su GitHub Pull Requests per aggiungere questa proprietà al tuo database.

   • Se non vedi l'elenco delle proprietà GitHub Pull Requests, vai su Settings → More Settings → Connections → Aggiungi GitHub Pull Request.

3. Assicurati che il tuo database abbia una Unique ID property. Questa proprietà verrà aggiunta al tuo database se non ne ha già una.

4. Per utilizzare la proprietà GitHub Pull Request, assicurati di aver collegato il tuo account GitHub a Notion. Quindi, aggiungi l'ID univoco dell'attività di Notion alla pull request oppure incolla l'URL della pull request di GitHub nella proprietà.

Per impostazione predefinita, Notion abilita i backlink sulle attività di Notion verso GitHub. Se vuoi disattivarli, fai clic sulla proprietà GitHub Pull Request nel tuo database → Edit property. Disattiva Linkbacks in GitHub.

Puoi utilizzare la proprietà GitHub Pull Requests per aggiornare automaticamente lo stato delle tue attività in Notion.

1. Seleziona il titolo della tua proprietà GitHub Pull Requests e fai clic su Modifica proprietà.

2. Trova la sezione Auto-update e seleziona la proprietà di stato che desideri aggiornare dal menu a discesa.

3. Seleziona lo stato dell'attività da impostare quando la pull request di GitHub viene aperta, viene richiesta una revisione, viene approvata e viene unita.

4. Ora, quando la pull request avanza in GitHub, lo stato della tua attività in Notion verrà aggiornato automaticamente in base alle tue impostazioni.

Puoi anche mostrare l'attività di GitHub nell'attività Notion collegata. Per farlo, fai clic sulla proprietà GitHub nel tuo database → Edit property. Attiva Activity Comments.

Se desideri collegare una pull request di GitHub a una o più attività Notion, inserisci semplicemente una parola magica e l'unique ID delle attività Notion nella descrizione della tua pull request.

Le parole magiche sono parole chiave che aiutano a stabilire relazioni tra le attività Notion e le pull request di GitHub. Puoi utilizzare una qualsiasi delle seguenti parole:

• close, closes, closed

• fix, fixes, fixed

• resolve, resolves, resolved

• complete, completes, completed, completing

• ref, references

• part of

• relazione a

• contributes to

• towards

Ad esempio, la tua pull request potrebbe avere la descrizione “fixes CTT-13”. Una volta impostata tale descrizione, la tua attività Notion con ID CTT-13 verrà collegata a quella pull request.

Se la descrizione della tua pull request utilizza parole magiche associate alla chiusura o al completamento di un'attività, l'attività Notion verrà contrassegnata come completata quando la pull request viene unita.

Se la descrizione della tua pull request utilizza parole magiche associate al riferimento o alla correlazione a un'attività, l'attività Notion non verrà contrassegnata come completata quando la pull request viene unita.

Puoi collegare le attività Notion solo come riferimento, in modo che tali attività non vengano contrassegnate come completate.

Per disconnettere GitHub da Notion, devi essere il proprietario dello spazio di lavoro.

1. Vai a Impostazioni.

2. Seleziona Connessioni.

3. Accanto a GitHub, seleziona ••• → Disconnetti tutti gli utenti.

Quando disconnetti GitHub da Notion, nessuno nel tuo spazio di lavoro potrà utilizzare la connessione finché non verrà configurata di nuovo.