diff --git a/README.md b/README.md
index 534cb0d91..f178ab74c 100644
--- a/README.md
+++ b/README.md
@@ -59,13 +59,13 @@ This is a list of latest features implemented in SpaceVim:
 Here is an example for using toml as SpaceVim config:
 
 ```toml
-# This is basic configuration example for SpaceVim
+# This is basic configuration example for SpaceVim.
 
-# All SpaceVim options below [option] section
+# All SpaceVim options below [options] snippet.
 [options]
-    # set spacevim theme. by default colorscheme layer is not loaded,
-    # if you want to use more colorschemes, please load the colorscheme
-    # layer
+    # Set SpaceVim theme. By default colorscheme layer is not loaded.
+    # If you want to use more colorschemes, please load the colorscheme
+    # layer.
     colorscheme = "gruvbox"
     colorscheme_bg = "dark"
     # Disable guicolors in basic mode, many terminal do not support 24bit
@@ -85,14 +85,14 @@ Here is an example for using toml as SpaceVim config:
 
 # Enable autocomplete layer
 [[layers]]
-name = 'autocomplete'
-auto-completion-return-key-behavior = "complete"
-auto-completion-tab-key-behavior = "cycle"
+    name = 'autocomplete'
+    auto-completion-return-key-behavior = "complete"
+    auto-completion-tab-key-behavior = "cycle"
 
 [[layers]]
-name = 'shell'
-default_position = 'top'
-default_height = 30
+    name = 'shell'
+    default_position = 'top'
+    default_height = 30
 ```
 
 **Iedit mode**
diff --git a/docs/cn/documentation.md b/docs/cn/documentation.md
index ee59dea55..bb0ad643e 100644
--- a/docs/cn/documentation.md
+++ b/docs/cn/documentation.md
@@ -857,8 +857,8 @@ Denite/Unite 是一个强大的信息筛选浏览器，这类似于 Emacs 中的
 
 ```toml
 [[custom_plugins]]
-name = 'lilydjwg/colorizer'
-merged = false
+    name = 'lilydjwg/colorizer'
+    merged = false
 ```
 
 #### 界面元素显示切换
@@ -1440,9 +1440,10 @@ endfunction
 | `SPC s w g` | Get Google suggestions in Vim. Opens Google results in Browser.          |
 | `SPC s w w` | Get Wikipedia suggestions in Vim. Opens Wikipedia page in Browser.(TODO) |
 
-**注意**: 为了在 Vim 中使用谷歌 suggestions，需要在 `~/.SpaceVim.d/init.toml` 的`[[options]]`片段中加入如下配置：
+**注意**: 为了在 Vim 中使用谷歌 suggestions，需要在 `~/.SpaceVim.d/init.toml` 的`[options]`片段中加入如下配置：
 
 ```toml
+[options]
     enable_googlesuggest = true
 ```
 
diff --git a/docs/documentation.md b/docs/documentation.md
index cdaadaf5a..8f314cb94 100644
--- a/docs/documentation.md
+++ b/docs/documentation.md
@@ -1172,7 +1172,7 @@ Navigation is centered on the `hjkl` keys with the hope of providing a fast navi
 
 ##### Open file with file tree.
 
-If there is only one file buffer opened, a file is opened in the active window, otherwise we need to use vim-choosewin to select a window to open the file.
+If only one file buffer is opened, a file is opened in the active window, otherwise we need to use vim-choosewin to select a window to open the file.
 
 | Key Bindings   | Descriptions                              |
 | -------------- | ----------------------------------------- |
@@ -1641,11 +1641,11 @@ In transient state:
 | `-`           | decrease the number under point by one |
 | Any other key | leave the transient state              |
 
-**Tips:** You can increase or decrease a value by more that once by using a prefix argument (i.e. `10 SPC n +` will add 10 to the number under point).
+**Tips:** You can increase or decrease a number by more than once by using a prefix argument (i.e. `10 SPC n +` will add 10 to the number under cursor).
 
 #### Replace text with iedit
 
-SpaceVim uses powerful iedit mode to quick edit multiple occurrences of a symbol or selection.
+SpaceVim uses a powerful iedit mode to quick edit multiple occurrences of a symbol or selection.
 
 **Two new modes:** `iedit-Normal`/`iedit-Insert`
 
@@ -1757,7 +1757,7 @@ These following features have been added to runner and repl plugin:
 
 ### Errors handling
 
-SpaceVim uses [neomake](https://github.com/neomake/neomake) to gives error feedback on the fly.
+SpaceVim uses [neomake](https://github.com/neomake/neomake) to give error feedback on the fly.
 The checks are only performed at save time by default.
 
 Errors management mappings (start with e):
@@ -1805,7 +1805,7 @@ Project manager commands start with `p`:
 
 ## EditorConfig
 
-SpaceVim has support [EditorConfig](http://editorconfig.org/), a configuration file to “define and maintain consistent coding styles between different editors and IDEs.”
+SpaceVim has supported [EditorConfig](http://editorconfig.org/), a configuration file to “define and maintain consistent coding styles between different editors and IDEs.”
 
 To customize your editorconfig experience, read the [editorconfig-vim package’s documentation](https://github.com/editorconfig/editorconfig-vim/blob/master/README.md).