Write documentation for the Github integration flow

# Problem

We need big picture "how it works" documentation for github integration flow and what it does.

A big chunk of it is explained in #1331 and some of it is additionally explained in #1370

However, it needs to be written in an easier to digest format for developers to refer to when working on integration features.

Empieza leyendo las issues #1331 y #1370, que contienen las explicaciones existentes del flujo de integración de GitHub. Convierte ese material en una referencia para desarrolladores más fácil de asimilar que cubra cómo funciona el flujo y qué hace. Se considera terminado cuando el comportamiento de la integración está documentado con la suficiente claridad para los desarrolladores que trabajan en funcionalidades de integración.

Escrito por el modelo de indexación a partir del texto del issue.