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.