From 0dc62cc706c17c22b8c035ddb35e9cd5638f8e53 Mon Sep 17 00:00:00 2001
From: Jan De Dobbeleer <jan.de.dobbeleer@gmail.com>
Date: Wed, 4 Nov 2020 11:41:34 +0100
Subject: [PATCH] chore: configuration context

---
 docs/docs/configuration.md | 21 ++++++++++++++-------
 docs/docs/installation.mdx |  4 ++--
 2 files changed, 16 insertions(+), 9 deletions(-)

diff --git a/docs/docs/configuration.md b/docs/docs/configuration.md
index 683718ff..cb7aa936 100644
--- a/docs/docs/configuration.md
+++ b/docs/docs/configuration.md
@@ -33,17 +33,22 @@ A really simple configuration could look like this.
 ```
 
 With this configuration, a single powerline segment is rendered that shows the name of the folder you're currently in.
-To set this configuration in combination with a [Oh my Posh executable][releases], make use of the `-config` flag to
-set a path to a json file containing the above code.
+To set this configuration in combination with a Oh my Posh [executable][releases], use the `-config` flag to
+set a path to a json file containing the above code. The `-shell universal` flag is used to print the prompt without
+escape characters to see the prompt as it would be shown inside a prompt function for your shell.
+
+:::info
+The command below will not persist the configuration for your shell but print the prompt in your terminal.
+If you want to use your own configuration permanently, adjust the [prompt configuration][promptconfig] to use your custom
+theme.
+:::
 
 ```bash
-oh-my-posh -config sample.json
+oh-my-posh -config sample.json -shell universal
 ```
 
-If all goes according to plan, you should see the prompt being printed out on the line below. This could bring us to
-the _first attention point_, you need to have a powerline enabled font installed on your machine and set as the font
-in your terminal to make use of, or see the symbols being used. All the themes were created with **Meslo Nerd Font**,
-which you can find [here][nf].
+If all goes according to plan, you should see the prompt being printed out on the line below. In case you see a lot of boxes with
+question marks, [set up your terminal][setupterm] to use a supported font before continuing.
 
 ## General Settings
 
@@ -284,6 +289,8 @@ override or transparent background color using the segement's [foreground][fg] p
 }
 ```
 
+[promptconfig]: /docs/installation#4-replace-your-existing-prompt
+[setupterm]: /docs/installation#1-setup-your-terminal
 [releases]: https://github.com/JanDeDobbeleer/oh-my-posh3/releases/latest
 [nf]: https://www.nerdfonts.com/
 [segments]: /docs/battery
diff --git a/docs/docs/installation.mdx b/docs/docs/installation.mdx
index 3520f650..782a9a41 100644
--- a/docs/docs/installation.mdx
+++ b/docs/docs/installation.mdx
@@ -1,7 +1,7 @@
 ---
 id: installation
-title: Manual Installation
-sidebar_label: Manual Installation
+title: Installation
+sidebar_label: Installation
 ---
 
 import Tabs from "@theme/Tabs";