update docs

dashboard/src/main/home/modals/AccountSettingsModal.tsx

@@ -79,7 +79,7 @@ const AccountSettingsModal = () => {
           {accessData.has_access ? (
             <Placeholder>
               <User>
-                You are currently authorized as <B>{accessData.username || "jusrhee"}</B> and have access to:
+                You are currently authorized as <B>{accessData.username}</B> and have access to:
               </User>
               {!accessData.accounts || accessData.accounts?.length == 0 ? (
                 <ListWrapper>

docs/guides/linking-github-account.md

@@ -6,10 +6,25 @@
 > over the next few weeks to transition to the authentication method below. After this, all old applications will still work as intended 
 > but new applications will need to be authenticated through the GitHub Application.
 
+Porter uses a GitHub application to authorize and gain access to your GitHub repositories. In order to be able to deploy
+applications through GitHub repositories, you must first authorize the Porter GitHub application to have
+access to them.
 
-Porter uses a GitHub application to authorize and gain access to your GitHub repositories. 
-In order to see your repositories on the web application, you first need to authorize the application through oauth. 
-You can do this by clicking "Account Settings" on the user dropdown on the top right and then authorizing the GitHub application through the link in the modal that appears.
-After you authorize the application, you can open the modal again to install your application in either your account or any organization you are part of. 
-Note that in organizations Porter will have access to every repository that the app is installed into regardless of who it was installed by. 
-So, if your organization does not grant you access to install applications, having an admin install the application into the appropriate organization repositories is sufficient.
+## Step 1: Authorize the Porter Application
+
+On your home page, click select "Account Settings" through the dropdown on the top right and click "connect your GitHub account"
+in the popup that opens:
+
+![image](https://user-images.githubusercontent.com/25856165/125105942-0acb6d00-e0ad-11eb-8254-6660d390daea.png)
+
+Then, follow the GitHub steps to authorize the application.
+
+## Step 2: Install App in your repositories
+
+Once the Application is authorized, you can see a list of accounts and organization the Porter has access to 
+through the same popup:
+
+![image](https://user-images.githubusercontent.com/25856165/125106692-ee7c0000-e0ad-11eb-9c79-44714f898aa5.png)
+
+You can install the app into more repositories by clicking on "Install Porter in more repositories". Note that if you are part of an organization, Porter will show you access to every repository that the app is installed into regardless of who it was installed by. 
+So, if your organization does not grant you access to install applications, having an admin install the application into the appropriate repositories is sufficient.