Integrar GitHub

La integración de Notion con GitHub te permite conectar a la perfección tus flujos de trabajo de desarrollo. Puedes enlazar contenido de GitHub directamente en las páginas de Notion, extraer información de GitHub e introducirla en las bases de datos de Notion y sincronizar solicitudes de extracción con tareas de Notion para que tu equipo esté informado del estado de los proyectos. Sigue leyendo para conocer las distintas funciones de la integración y cómo puedes configurarlas.

Para conectar Notion y la app de espacio de trabajo de GitHub, tendrás que ser tanto propietario de un espacio de trabajo de Notion como administrador de una organización de GitHub.

1. Ve a Configuración en la barra lateral.

2. Haz clic en Mis conexiones y busca GitHub (espacio de trabajo).

3. Haz clic en Conectar y completa el flujo de autenticación.

Enlaza un archivo o líneas específicas de un archivo directamente en Notion. Incluso puedes enlazar desde una confirmación o rama específica si quieres que el código al que haces referencia esté actualizado.

1. Copia el enlace permanente de las líneas que quieras de GitHub.

2. Pégalo en una página Notion y selecciona Pegar como vista previa para insertar el código en tu página.

Puedes sincronizar tus repositorios de GitHub (incluidas las solicitudes de extracción y las incidencias) en Notion como bases de datos. Para ello:

1. Si trabajas en GitHub, copia el enlace de un PR o un problema.

2. Pega el enlace en Notion y elige Pegar como base de datos.

   • Si todavía no lo has hecho, se te pedirá que inicies sesión y conectes Notion con tu cuenta de GitHub.

3. Se creará la base de datos sincronizada en una vista de tabla y se añadirán automáticamente todas las propiedades de GitHub.

4. Esta base de datos se rellenará de forma automática y se seguirá sincronizando incluso si sales de la página.

Aquí tienes una lista de las propiedades de GitHub compatibles:

Por el momento las etiquetas no son compatibles.

Puedes utilizar el mapeo de identidad de usuarios para conectar las identidades de GitHub con los perfiles de tu equipo en Notion. Para ello:

1. Ve a la configuración de correo electrónico de GitHub y verifica que la casilla Mantener mis direcciones de correo electrónico privadasno esté seleccionada.

2. En tu perfil de GitHub (https://github.com/{YOUR_USERNAME_HERE}), edita tu perfil para añadir una dirección de correo electrónico de Notion.

Esto permitirá que tu identidad se pueda mapear para las bases de datos sincronizadas en los espacios de trabajo de los que eres miembro.

La propiedad Pull Requests de GitHub dentro de tu base de datos de Notion mantendrá informados automáticamente a tus diferentes equipos sobre el estado de las tareas. También tiene muchos atributos que puedes usar en resúmenes, fórmulas y filtros.

1. En una base de datos de Notion, haz clic en + para añadir una nueva propiedad.

2. Busca y haz clic en Pull Requests de GitHub para añadir esta propiedad a tu base de datos.

3. Asegúrate de que la base de datos tenga una propiedad de ID único. Esta propiedad se añadirá a tu base de datos si aún no tiene una.

4. Para usar la propiedad Pull Requests de GitHub, asegúrate de haber conectado tu cuenta de GitHub con Notion. Luego, añade el ID único de la tarea de Notion al pull request o pega la URL del pull request de GitHub en la propiedad.

De forma predeterminada, Notion habilita los enlaces de retorno en las tareas de Notion a GitHub. Si deseas desactivar esto, haz clic en la propiedad Pull Requests de GitHub en tu base de datos → Editar propiedad. Desactiva los Enlaces de retorno en GitHub.

Puedes usar la propiedad PR de GitHub para que actualice automáticamente el estado de tus tareas en Notion.

1. Selecciona el título de la propiedad PR de GitHub y haz clic en Editar propiedad.

2. Busca la sección Actualización automática y selecciona la propiedad de estado que quieres actualizar mediante el menú desplegable.

3. Selecciona el estado que establecer en la tarea cuando el estado del PR de GitHub sea Abierto, Revisión solicitada, Aprobado o Fusionado.

4. A partir de ahora, cuando el PR pase de una fase a otra en GitHub, el estado de tu tarea en Notion se actualizará de acuerdo con tu configuración.

También puedes mostrar la actividad de GitHub en la tarea de Notion enlazada. Para ello, haz clic en la propiedad de GitHub de la base de datos → Editar propiedad. Activa los comentarios de actividad.

Si quieres enlazar un PR de GitHub a una o más tareas de Notion, simplemente ingresa una palabra mágica y el ID único de las tareas de Notion en la descripción de tu solicitud de extracción.

Las palabras mágicas son palabras clave que ayudan a establecer relaciones entre las tareas de Notion y los PR de GitHub. Puedes usar cualquiera de las siguientes palabras:

• cerrar, cierra, cerrado

• arreglar, arregla, arreglado

• resolver, resuelve, resuelto

• completar, completa, completado, completando

• ref, referencias

• parte de

• relacionada con

• contribuye a

• hacia

Por ejemplo, tu PR podría tener la descripción «corrige CTT-13». Una vez establecida esa descripción, tu tarea de Notion con el ID CTT-13 se vinculará con esa PR.

Si la descripción del PR utiliza palabras mágicas asociadas con el cierre o la finalización de una tarea, la tarea de Notion se marcará como terminada cuando se combine el PR.

Si la descripción de tu solicitud de extracción utiliza palabras mágicas asociadas con la referencia o relación a una tarea, la tarea Notion no se marcará como realizada cuando se fusione el PR.

Puedes enlazar tareas de Notion como solo de referencia, de modo que esas tareas no se marquen como finalizadas.

Para desconectar GitHub de Notion, tendrás que ser propietario de un espacio de trabajo de Notion.

1. Ve a Configuración.

2. Selecciona Conexiones.

3. Junto a GitHub, selecciona ••• → Desconectar a todos los usuarios.

Cuando desconectes GitHub de Notion, nadie en tu espacio de trabajo podrá utilizar la integración hasta que se vuelva a configurar.