From 08b9befe0ef4f789aa079acff836316756778b69 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ellen=20K=C3=B6rbes?= <ellenkorbes@gmail.com>
Date: Tue, 3 Jul 2018 18:16:41 -0300
Subject: [PATCH] docs: add FAQs section and tmux/colors info

---
 docs/README.md                | 1 +
 docs/introduction/README.md   | 1 +
 docs/introduction/the-faqs.md | 6 ++++++
 3 files changed, 8 insertions(+)
 create mode 100644 docs/introduction/the-faqs.md

diff --git a/docs/README.md b/docs/README.md
index f5839c4507..c352d61932 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -4,6 +4,7 @@
 * [Introduction](./introduction/README.md)
   * [Getting Started](./introduction/getting-started.md)
   * [Motivation](./introduction/motivation.md)
+  * [The FAQs](./introduction/the-faqs.md)
 * [Guides](./guides/README.md)
   * [Configuration](./guides/configuration.md)
   * [Using Garden with Minikube](./guides/minikube.md)
diff --git a/docs/introduction/README.md b/docs/introduction/README.md
index a0c65a1454..91da11f3a7 100644
--- a/docs/introduction/README.md
+++ b/docs/introduction/README.md
@@ -2,3 +2,4 @@
 
 * [Getting Started](./getting-started.md)
 * [Motivation](./motivation.md)
+* [The FAQs](./the-faqs.md)
diff --git a/docs/introduction/the-faqs.md b/docs/introduction/the-faqs.md
new file mode 100644
index 0000000000..36e78b85ed
--- /dev/null
+++ b/docs/introduction/the-faqs.md
@@ -0,0 +1,6 @@
+# The FAQs
+
+### When using garden inside tmux, colors look wonky. What gives?
+
+You need to set tmux to use 256 colors. As per the [official documentation](https://github.com/tmux/tmux/wiki/FAQ#how-do-i-use-a-256-colour-terminal), you 
+can do that by adding `set -g default-terminal "screen-256color"` or `set -g default-terminal "tmux-256color"` to your `~/.tmux.conf` file.