Minor fixes

Katie Horne · Katie Horne · commit b5b793875242 · 2021-08-06T11:27:28.000-05:00
diff --git a/guides/troubleshooting/git-oauth.md b/guides/troubleshooting/git-oauth.md
@@ -1,33 +1,34 @@
 ---
-title: Troubleshooting GitHub OAuth integration
-description: Troubleshooting "Failed to link account" OAuth error
+title: GitHub OAuth integration
+description: Learn how to fix a "Failed to link account" OAuth error.
 ---
 
-When configuring the OAuth integration between Coder & GitHub, you
-may encounter the error below:
+When configuring the OAuth integration between Coder and GitHub, you may
+encounter the following error:
 
 ![Failed to link](../../assets/guides/troubleshooting/oauth-error.png)
 
 ## Why this happens
 
-This happens when your Coder public key has been uploaded to your
-GitHub profile prior to your attempt to link Coder & GitHub. The error is thrown
-due to the OAuth integration duplicating your public key in GitHub.
+This error occurs when your Coder public key has been uploaded to your GitHub
+profile; when you attempt to link Coder and GitHub, the OAuth integration
+attempts to add your public key again to GitHub.
 
 ## Solution
 
-1. Remove your Coder public key from your GitHub account
+1. [Remove your Coder public key](https://docs.github.com/en/github/authenticating-to-github/keeping-your-account-and-data-secure/reviewing-your-ssh-keys)
+   from your GitHub account.
 
-1. In Coder, navigate to **Account** > **Linked Accounts** and click
-**Link Your GitHub Account**
+1. In Coder, navigate to **Account** > **Linked Accounts** and click **Link Your
+   GitHub Account**.
 
-1. If successful, you will be re-directed back to the account page, with a
-   message in the bottom right corner stating:
+1. If successful, you will be re-directed back to the **Account** page. There
+   will be a message in the bottom right corner that says:
 
    ```console
    Successfully linked to GitHub account <your-GitHub-username>
    ```
 
-If the above is not the source of the issue, then it may be
-related to your configuration values in Coder's Admin panel. To view such values
-navigate to **Manage** > **Admin** > **Git OAuth**.
+If the steps above do not fix the problem, the error may be related to the
+GitHub configuration values set using Coder's **Admin** panel. Site managers can
+view and update these values at **Manage** > **Admin** > **Git OAuth**.
