From aedd41eac4ab2930b9dbded4b410da5f26bda1ef Mon Sep 17 00:00:00 2001
From: James Munns <james@onevariable.com>
Date: Tue, 21 Nov 2023 15:38:33 +0100
Subject: [PATCH] Add FAQ with one question from chat

---
 docs/modules/ROOT/nav.adoc       |  1 +
 docs/modules/ROOT/pages/faq.adoc | 24 ++++++++++++++++++++++++
 2 files changed, 25 insertions(+)
 create mode 100644 docs/modules/ROOT/pages/faq.adoc

diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc
index ee559a821..7e178df62 100644
--- a/docs/modules/ROOT/nav.adoc
+++ b/docs/modules/ROOT/nav.adoc
@@ -10,3 +10,4 @@
 * xref:examples.adoc[Examples]
 * xref:developer.adoc[Developer]
 ** xref:developer_stm32.adoc[Developer: STM32]
+* xref:faq.adoc[Frequently Asked Questions]
diff --git a/docs/modules/ROOT/pages/faq.adoc b/docs/modules/ROOT/pages/faq.adoc
new file mode 100644
index 000000000..5b58580d0
--- /dev/null
+++ b/docs/modules/ROOT/pages/faq.adoc
@@ -0,0 +1,24 @@
+= Frequently Asked Questions
+
+These are a list of unsorted, commonly asked questions and answers.
+
+Please feel free to add items to link:https://github.com/embassy-rs/embassy/edit/main/docs/modules/ROOT/pages/faq.adoc[this page], especially if someone in the chat answered a question for you!
+
+== Missing main macro
+
+If you see an error like this:
+
+[source,rust]
+---
+#[embassy_executor::main]
+|                   ^^^^ could not find `main` in `embassy_executor`
+---
+
+You are likely missing some features of the `embassy-executor` crate.
+
+For Cortex-M targets, consider making sure that ALL of the following features are active in your `Cargo.toml` for the `embassy-executor` crate:
+
+* `arch-cortex-m`
+* `executor-thread`
+* `nightly`
+