Add docs about setting up permissions for GH apps & orgs #8305
Conversation
This is a common issue, so now we at least have a link to point users to.
| Many organizations require approval for each OAuth application that is used, | ||
| or you might have disabled it in the past for your personal account. | ||
| This can happen at the personal or organization level, | ||
| depending on where the project you are trying to access has permissions from. |
There was a problem hiding this comment.
It might be helpful to discuss the outcome to the user here as well. The question I always field is "why are my repositories not in my list of repositories I can import" or "why is my organization missing from the import page". I'd like to link to this section in the dashboard UI later, so hopefully can help direct users at the source.
There was a problem hiding this comment.
Aye -- I don't know the best way to structure it, so I just put it in bold for now.
Co-authored-by: Anthony <aj@ohess.org>
| @@ -13,8 +13,7 @@ Connecting your account allows for: | |||
| If you signed up or logged in to Read the Docs with your GitHub, Bitbucket, or GitLab | |||
| credentials, you're all done. Your account is connected. | |||
|
|
|||
| To connect your unconnected account, go to your *Settings* dashboard | |||
| and select `Connected Services <https://readthedocs.org/accounts/social/connections/>`_. | |||
| To connect a social account, go to your :guilabel:`Username dropdown` > :guilabel:`Settings` > :guilabel:`Connected Services`. | |||
There was a problem hiding this comment.
I think we should still mention the link, something like "go to this link or ...". It is easier to just click than search for the UI elements.
There was a problem hiding this comment.
We need a way to link to both sites, if we're providing a link..
| @@ -66,6 +65,38 @@ Repository status (``repo:status``) | |||
| but there isn't a more granular permission | |||
| that only allows setting up SSH keys for read access. | |||
|
|
|||
| .. _github-permission-troubleshooting: | |||
There was a problem hiding this comment.
We are using autolabel, there is no need for this, at least I'm missing something?
There was a problem hiding this comment.
I think I added this prior to adding the section label.
Co-authored-by: Manuel Kaufmann <humitos@gmail.com>
Co-authored-by: Manuel Kaufmann <humitos@gmail.com>
This is a common issue,
so now we at least have a link to point users to.
Closes #7381