Document troubleshooting the Deployments GitHub App

[caboog]

Hello!

• Vote on this issue by adding a 👍 reaction
• If you want to implement this feature, comment to let us know (we'll work with you on design, scheduling, etc.)

Issue details

The documentation around our Deployments GitHub app could use some attention. Most of what I come across assumes it all Just Works.

Affected area/feature

[cnunciato]

See also https://github.com/pulumi/docs/issues/11718.