diff --git a/docs/configuration.md b/docs/configuration.md
index cec4a06ca56..267bdfd3514 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -9,35 +9,6 @@ menu:
     weight: 40
 ---
 
-# Default Directories
-
-Poetry uses these following default directories
-
-## Config Directory
-
-- Linux: `$XDG_CONFIG_HOME/pypoetry` or `~/.config/pypoetry`
-- Windows: `%APPDATA%\pypoetry`
-- MacOS: `~/Library/Preferences/pypoetry`
-
-You can override this Config directory by setting `POETRY_CONFIG_DIR` environment variable
-
-
-## Data Directory
-
-- Linux: `$XDG_DATA_HOME/pypoetry` or `~/.local/share/pypoetry`
-- Windows: `%APPDATA%\pypoetry`
-- MacOS: `~/Library/Application Support/pypoetry`
-
-You can override this Data Directory by setting `POETRY_DATA_DIR` environment variable. If `POETRY_HOME` environment variable is available, then `POETRY_HOME` will be given higher priority.
-
-## Cache Directory
-
-- Linux: `$XDG_CACHE_HOME/pypoetry` or `~/.cache/pypoetry`
-- Windows: `%APPDATA%\pypoetry\Cache`
-- MacOS: `~/Library/Caches/pypoetry`
-
-You can override this Cache directory by setting `POETRY_CACHE_DIR` environment variable
-
 # Configuration
 
 Poetry can be configured via the `config` command ([see more about its usage here]({{< relref "cli#config" >}} "config command documentation"))
@@ -144,6 +115,35 @@ This also works for secret settings, like credentials:
 export POETRY_HTTP_BASIC_MY_REPOSITORY_PASSWORD=secret
 ```
 
+## Default Directories
+
+Poetry uses these following default directories
+
+### Config Directory
+
+- Linux: `$XDG_CONFIG_HOME/pypoetry` or `~/.config/pypoetry`
+- Windows: `%APPDATA%\pypoetry`
+- MacOS: `~/Library/Preferences/pypoetry`
+
+You can override this Config directory by setting `POETRY_CONFIG_DIR` environment variable
+
+
+### Data Directory
+
+- Linux: `$XDG_DATA_HOME/pypoetry` or `~/.local/share/pypoetry`
+- Windows: `%APPDATA%\pypoetry`
+- MacOS: `~/Library/Application Support/pypoetry`
+
+You can override this Data Directory by setting `POETRY_DATA_DIR` environment variable. If `POETRY_HOME` environment variable is available, then `POETRY_HOME` will be given higher priority.
+
+### Cache Directory
+
+- Linux: `$XDG_CACHE_HOME/pypoetry` or `~/.cache/pypoetry`
+- Windows: `%APPDATA%\pypoetry\Cache`
+- MacOS: `~/Library/Caches/pypoetry`
+
+You can override this Cache directory by setting `POETRY_CACHE_DIR` environment variable
+
 ## Available settings
 
 ### `cache-dir`