Multiple documentation omissions for upgrading self-hosted install to version 3.0.0

[George Joseph]

URL to the linked Repository or Organization

https://github.com/

Steps to reproduce the problem

1. Attempt to upgrade an organization-level self-hosted install to 3.0.0 using README.md

What is the expected result?

It works.

What happens instead?

Multiple auth related failures mostly in the form of "Resource not accessible by integration"

Any other information? (attach screenshot if possible)

Used browser and browser version?

Any other tested browsers/devices(OK/FAIL):

Issues discovered:

For the GitHub APP:

• The following fields need to be set:
  • The callback URL needs to be set but it needs to be set to almost the same as the OAuth app. Instead of /callback, it needs to be /app-callback.
  • "Request user authorization (OAuth) during installation" needs to be checked.
• The README says "add repository permissions for Pull Requests" but you need a lot more...
  • R/W for Repo Commit Statuses
  • R/W for Repo Merge Queues
  • R/W for Repo Webhooks
  • R/O for Org Administration
  • R/O for Org Members
  • R/W for Org Webhooks
  • R/W for Acct Gists