diff --git a/docs/docs/faq.mdx b/docs/docs/faq.mdx
index 391506ba..46f253e3 100644
--- a/docs/docs/faq.mdx
+++ b/docs/docs/faq.mdx
@@ -180,6 +180,15 @@ export VIRTUAL_ENV_DISABLE_PROMPT=1
 </TabItem>
 </Tabs>
 
+### Text decoration styles like bold and dimmed don't work
+The text decoration styles are based on your terminal's capabilities.
+
+A quick way to check if your terminal supports the specific style escape sequence is to take a look at the `terminfo` database, on Linux.
+Refer [this page on ArchWiki](https://wiki.archlinux.org/title/Bash/Prompt_customization#Terminfo_escape_sequences).
+
+If you are on Windows, use Windows Terminal. It closely copies the `xterm-256color` capabilities.
+See the [PowerShell docs] and [this GitHub comment](https://github.com/microsoft/terminal/issues/6045#issuecomment-631743728).
+
 [git-gc]: https://git-scm.com/docs/git-gc
 [new-issue]: https://github.com/JanDeDobbeleer/oh-my-posh/issues/new/choose
 [latest]: https://github.com/JanDeDobbeleer/oh-my-posh/releases/latest