Integrar ao GitHub

A integração do Notion com o GitHub permite que você conecte perfeitamente os seus fluxos de trabalho de desenvolvimento. Você pode vincular conteúdo do Github diretamente a páginas do Notion, extrair informações do Github para bases de dados do Notion, além de sincronizar solicitações de atualização com tarefas do Notion para manter toda a equipe informada sobre status de projetos. Continue lendo para saber mais sobre os diferentes recursos da integração e como você pode configurá-los.

Você precisa ser proprietário de um espaço de trabalho no Notion e um administrador de organização no Github para fazer esta conexão.

1. Acesse Configurações na barra lateral.

2. Clique em Minhas conexões e localize GitHub (Espaço de trabalho).

3. Clique em Conectar e siga o fluxo de autenticação.

Vincule um arquivo ou linhas específicas de um arquivo diretamente no Notion. Você pode até mesmo criar um link de um commit ou branch específico se quiser que o código referenciado mantenha-se atualizado.

1. Copie o permalink nas suas linhas desejadas do GitHub.

2. Cole-o em uma página do Notion e selecione Colar como visualização para integrar o código na sua página.

Você pode sincronizar repositórios do Github (incluindo solicitações de atualização e itens) para bases de dados do Notion. Confira o passo a passo:

1. No GitHub, copie o link de um pull request ou problema.

2. Cole o link no e selecione Colar como base de dados.

   • Caso você ainda não tenha feito isso, será preciso fazer login para conectar o Notion à sua conta do GitHub.

3. A base de dados sincronizada será criada em uma visualização em tabela, adicionando todas as propriedades do GitHub automaticamente.

4. A base de dados começará a ser preenchida automaticamente e manterá a sincronização mesmo que você saia da página.

Confira uma lista de propriedades do Github compatíveis com o Notion:

Rótulos e tags não são compatíveis no momento.

Você pode usar o mapeamento de identidade para conectar identidades do Github aos perfis Notion da sua equipe. Confira o passo a passo:

1. Acesse as Configurações de e-mail do GitHub e certifique-se de que a configuração Manter meus endereços de e-mail privados está desmarcada.

2. No seu perfil do GitHub, (https://github.com/{SEU_NOME_DE_USUÁRIO_AQUI), edite seu perfil para adicionar seu endereço de e-mail do Notion.

Com isso, sua identidade poderá ser mapeada para bases de dados sincronizadas nos espaços de trabalho dos quais você é membro.

A propriedade Solicitação de atualização do GitHub dentro das bases de dados do Notion serve para manter todas as equipes na empresa informadas sobre o status das tarefas. O recurso também tem muitos atributos que você pode usar em rollups, fórmulas e filtros.

1. Em um banco de dados do Notion, clique em + para adicionar uma nova propriedade.

2. Pesquise e clique em Solicitação de atualização do GitHub para adicionar essa propriedade ao seu banco de dados.

3. Certifique-se de que a base de dados tenha uma propriedade de ID exclusivo. Essa propriedade será adicionada à base de dados, caso ainda não haja uma.

4. Para usar a propriedade Solicitação de atualização do GitHub, certifique-se de que você vinculou sua conta do GitHub ao Notion. Depois, adicione o ID exclusivo da tarefa do Notion à solicitação de atualização ou cole o URL da solicitação de atualização do GitHub na propriedade.

Por padrão, o Notion permite links internos nas tarefas do Notion para o GitHub. Se quiser desativar isso, clique na propriedade Solicitações de atualização do GitHub no seu banco de dados → Editar propriedade. Desative os links internos no GitHub.

Você pode usar a propriedade Pull Requests do GitHub para atualizar automaticamente o status das suas tarefas no Notion.

1. Selecione o título da sua propriedade Pull Requests do GitHub e clique em Editar propriedade.

2. Na seção Atualização automática, selecione no menu suspenso a propriedade de status que você deseja atualizar.

3. Selecione o status da tarefa a ser definido quando o PR do GitHub estiver como Aberto, Revisão solicitada, Aprovado e Mesclado.

4. Agora, quando o PR avançar no GitHub, o status da sua tarefa no Notion será atualizado automaticamente de acordo com as suas configurações.

Você também pode mostrar a atividade do GitHub na tarefa vinculada do Notion. Para isso, clique na propriedade do GitHub no seu banco de dados → Editar propriedade. Ative os comentários da atividade.

Se quiser vincular um GitHub PR a uma ou mais tarefas do Notion, basta digitar uma palavra mágica e o ID exclusivo das tarefas do Notion na descrição do seu PR.

Palavras mágicas são palavras-chave que ajudam a estabelecer relações entre as tarefas do Notion e os PRs do GitHub. Você pode usar qualquer uma das seguintes palavras:

• fechar, fecha, fechado

• corrigir, corrige, corrigido

• resolver, resolve, resolvido

• completar, complete, completo, completado, completando

• ref, referências

• parte de

• relacionado a

• contribui para

• em direção a

Por exemplo, seu PR poderia ter a descrição "corrige CTT-13". Depois que essa descrição for definida, sua tarefa Notion com o ID CTT-13 será vinculada a esse PR.

Se a descrição do seu PR usar palavras mágicas associadas ao fechamento ou à conclusão de uma tarefa, a tarefa do Notion será marcada como concluída quando o PR for mesclado.

Se a descrição do PR usar palavras mágicas associadas à referência ou à relação com uma tarefa, a tarefa do Notion não será marcada como concluída quando o PR for mesclado.

Você pode vincular tarefas do Notion como somente de referência, para que essas tarefas não sejam marcadas como concluídas.

Para desvincular o Github do Notion, você precisa ser proprietário do espaço de trabalho no Notion.

1. Acesse Configurações.

2. Selecione Conexões.

3. Ao lado de GitHub, selecione ••• → Desconectar todos os usuários.

Depois de desvincular o Github do Notion, ninguém mais no seu espaço de trabalho poderá usar a integração até que seja configurada novamente.