docs: updates for the GitHub external service

Created by: ryan-blunden

Inspired by #2895 and learning how repo querying works.

I've aimed to more fully explain the repository syncing design/strategy, as well as adding important points such as which token to use.

This is not to replace the schema docs, but provide a high level understanding so the schema is more easily understandable.