diff --git a/docs/layers/github.md b/docs/layers/github.md
index 3bc7afad3..f317a1962 100644
--- a/docs/layers/github.md
+++ b/docs/layers/github.md
@@ -20,7 +20,7 @@ This layer provides GitHub integration for SpaceVim.
 
 ## Install
 
-To use this configuration layer, add following snippet to your custom configuration file.
+To use this configuration layer, add the following snippet to your custom configuration file.
 
 ```toml
 [[layers]]
@@ -42,7 +42,7 @@ To use this configuration layer, add following snippet to your custom configurat
 
 ## Extra configuration for GitHub and Gist
 
-For avoid repeating input the account name and passwrod, you need to add the belowing contennt for auto .SpaceVim.d/autoload/myspacevim.vim [Bootstrap Functions](https://spacevim.org/documentation/#bootstrap-functions).
+To avoid needing to constantly input your username and password, you'll want to create the following [Bootstrap Function](https://spacevim.org/documentation/#bootstrap-functions) in a file such as .SpaceVim.d/autoload/myspacevim.vim.
 
 ```vim
 func! myspacevim#before() abort
@@ -51,7 +51,7 @@ func! myspacevim#before() abort
   let g:gista#client#default_username = 'monkeyxite'
 endf
 ```
-Refer [github dashboard](https://github.com/junegunn/vim-github-dashboard), for security concerns you could create a Personal Access Token, export it as an environment variable and use it as a password.
+We recommend generating a [personal access token](https://help.github.com/en/articles/creating-a-personal-access-token-for-the-command-line) and storing it securely in an environment variable. [Refer to github dashboard](https://github.com/junegunn/vim-github-dashboard) for more information.
 ```shell
 # in some secure file sourced in your .bashrc, .bash_profile, .zshrc, etc.
 export GITHUB_TOKEN="<your 40 char token>"