Integra GitHub

La integración de Notion con GitHub te permite conectar tus flujos de trabajo de desarrollo sin problemas. Puedes vincular el contenido de GitHub directamente a tus páginas de Notion, ingresar información de GitHub a bases de datos de Notion, y sincronizar solicitudes de incorporación de cambios con tareas de Notion para mantener a tu equipo al día sobre el estado de los proyectos. Sigue leyendo para conocer las distintas funciones de la integración y cómo configurarlas.

Para conectar Notion con la aplicación del espacio de trabajo de Github necesitas ser propietario de un espacio de trabajo de Notion y 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 sigue los pasos para completar la autentificación.

Enlace a un archivo o líneas específicas de un archivo directamente en Notion. Incluso puedes vincular desde una asignación o rama específica si deseas que el código al que haces referencia esté actualizado.

1. Copia el enlace permanente para las líneas en cuestión desde GitHub.

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

Puedes sincronizar tus repositorios de GitHub (incluyendo incidencias y solicitudes de incorporación de cambios) como bases de datos de Notion. Para ello:

1. En GitHub, copia el enlace de una solicitud de incorporación de cambios o una incidencia.

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 agregarán todas las propiedades de GitHub de forma automática.

4. La base de datos se completará de forma automática y se seguirá sincronizando incluso si dejas la página.

Esta es una lista de las propiedades de GitHub que están permitidas:

Las etiquetas no están permitidas por ahora.

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

1. Dirígete a la configuración de Configuración de correo electrónico de GitHub y asegúrate de que la casilla Mantener mis direcciones de correo electrónico privadas esté desactivada.

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

Esto permitirá que tu identidad se traslade a las bases de datos sincronizadas en los espacios de trabajo de los que eres miembro.

La propiedad de PR de GitHub en tu base de datos de Notion mantendrá informados a todos los equipos con las actualizaciones automáticas de estados. También tiene muchos atributos que puede usar en resúmenes, fórmulas y filtros.

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

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

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

4. Para usar la propiedad GitHub Pull Request, asegúrate de haber conectado tu cuenta de GitHub con Notion. Luego, agrega el ID único de la tarea de Notion a la solicitud de extracción o pega la URL de la solicitud de extracción de GitHub en la propiedad.

De forma predeterminada, Notion habilita los enlaces internos en las tareas de Notion a GitHub. Si deseas desactivar esto, haz clic en la propiedad Solicitud de extracción de GitHub en tu base de datos → Editar propiedad. Desactiva los enlaces internos en GitHub.

Puedes usar la propiedad de PRs de GitHub para actualizar de forma automática los estados de tus tareas en Notion.

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

2. Busca la sección Autocompletado y selecciona la propiedad de estado que quieras actualizar desde el menú desplegable.

3. Selecciona el estado que quieres que aparezca en la tarea para cuando el estado de la PR de GitHub sea Abierta, Revisión solicitada, Aprobada o Incorporada.

4. Cuando haya cambios en el estado de la PR en GitHub, el estado de la tarea en Notion se actualizará automáticamente de acuerdo a cómo haya sido configurada.

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

Si deseas 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 PR.

Las palabras mágicas son palabras clave que ayudan a establecer relaciones entre las tareas de Notion y las solicitudes de incorporación de cambios 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 enlazará con ese PR.

Si la descripción de la solicitud de incorporación de cambios utiliza palabras mágicas asociadas con el cierre o la finalización de una tarea, la tarea de Notion se marcará como “listo” cuando se combine la solicitud de incorporación de cambios.

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

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

Para desconectar GitHub de Notion, se necesita ser propietario de un espacio de trabajo en Notion.

1. Ve a Configuración.

2. Selecciona Conexiones.

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

Si desconectas GitHub de Notion, nadie en tu espacio de trabajo podrá usar la integración hasta que se vuelva a configurar.