From ca2605fdbedbd8a76ad7b3c6ca1087afc70ffa47 Mon Sep 17 00:00:00 2001
From: wusanny <141895372+wusanny@users.noreply.github.com>
Date: Tue, 30 Jul 2024 19:49:23 +1000
Subject: [PATCH] Update github-permissions.md (#5860)
## What are you changing in this pull request and why?
Existing documentation on how to accept/update new Github app permission
is lacking the visualisation for confused customers (me included!) to
find exactly where the Settings are and what they should see under
Applications.
I managed to navigate to the right spot, but I was not sure where should
I be seeing this 'accept permissions' and if I can even see it. I also
noticed a few customers checking their repository settings instead of
their account settings.
Hoping the images and clarification on steps will provide a clearer
understanding for the customers.
## Checklist
- [x] Review the [Content style
guide](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/content-style-guide.md)
so my content adheres to these guidelines.
- [x] For [docs
versioning](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#about-versioning),
review how to [version a whole
page](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#adding-a-new-version)
and [version a block of
content](https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/single-sourcing-content.md#versioning-blocks-of-content).
- [x] Add a checklist item for anything that needs to happen before this
PR is merged, such as "needs technical review" or "change base branch."
---------
Co-authored-by: Mirna Wong <89008547+mirnawong1@users.noreply.github.com>
---
website/docs/faqs/Git/github-permissions.md | 32 ++++++++++++------
.../github-applications.jpg | Bin 0 -> 996285 bytes
.../github-review-request.jpg | Bin 0 -> 138308 bytes
.../github-settings.jpg | Bin 0 -> 139295 bytes
.../repository-details-faq.jpg | Bin 0 -> 153419 bytes
5 files changed, 22 insertions(+), 10 deletions(-)
create mode 100644 website/static/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/github-applications.jpg
create mode 100644 website/static/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/github-review-request.jpg
create mode 100644 website/static/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/github-settings.jpg
create mode 100644 website/static/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/repository-details-faq.jpg
diff --git a/website/docs/faqs/Git/github-permissions.md b/website/docs/faqs/Git/github-permissions.md
index e3a1740bbab..075343e0c5e 100644
--- a/website/docs/faqs/Git/github-permissions.md
+++ b/website/docs/faqs/Git/github-permissions.md
@@ -6,29 +6,41 @@ sidebar_label: "GitHub and dbt Cloud permissions error"
If you see the error `This account needs to accept the latest permissions for the dbt Cloud GitHub App` in dbt Cloud — this usually occurs when the permissions for the dbt Cloud GitHub App are out of date.
-To solve this issue, you'll need to update the permissions for the dbt Cloud GitHub App in your GitHub account. Here's a couple of ways you can do it:
+To solve this issue, you'll need to update the permissions for the dbt Cloud GitHub App in your GitHub account. This FAQ shares a couple of ways you can do it.
-#### Update permissions
+## Update permissions
-A Github organization admin will need to update the permissions in GitHub for the dbt Cloud GitHub App. If you're not the admin, reach out to your organization admin to request this. Alternatively, try [disconecting your GitHub account](#disconect-github) in dbt Cloud.
+A GitHub organization admin will need to update the permissions in GitHub for the dbt Cloud GitHub App. If you're not the admin, reach out to your organization admin to request this.
+
+1. Navigate to your GitHub account. Click on the top right profile icon and then **Settings** (or personal if using a non-organization account).
+
+
+
+2. Then go to **Integrations** and then select **Applications** to identify any necessary permission changes. Note that a GitHub repository admin may not see the same permission request.
+
+
+
+3. Click on **Review request** and then click on the **Accept new permissions** button on the next page.
+
+
-1. Go directly to GitHub to determine if any updated permissions are required.
-2. In GitHub, go to your organization **Settings** (or personal if using a non-organization account).
-3. Then navigate to **Applications** to identify any necessary permission changes.
For more info on GitHub permissions, refer to [access permissions](https://docs.github.com/en/get-started/learning-about-github/access-permissions-on-github).
-#### Disconnect GitHub
+Alternatively, try [disconecting your GitHub account](#disconect-github) in dbt Cloud, detailed in the following section.
+
+## Disconnect GitHub
Disconnect the GitHub and dbt Cloud integration in dbt Cloud.
1. In dbt Cloud, go to **Account Settings**.
-2. In **Projects**, select the project that's experiencing the issue.
+2. In **Projects**, select the project experiencing the issue.
3. Click the repository link under **Repository**.
4. In the **Repository details** page, click **Edit**.
5. Click **Disconnect** to remove the GitHub integration.
-6. Go back to your **Project details** page and reconnect your repository by clicking the **Configure Repository** link.
+6. Return to your **Project details** page and reconnect your repository by clicking the **Configure Repository** link.
7. Configure your repository and click **Save**
-
+
+## Support
If you've tried these workarounds and are still experiencing this behavior — reach out to the [dbt Support](mailto:support@getdbt.com) team and we'll be happy to help!
diff --git a/website/static/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/github-applications.jpg b/website/static/img/docs/dbt-cloud/cloud-configuring-dbt-cloud/github-applications.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..9c2208df66798140320a41927ed3127790cc4be8
GIT binary patch
literal 996285
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