diff --git a/.github/readme.md b/.github/readme.md
index 7c12627..20e718c 100644
--- a/.github/readme.md
+++ b/.github/readme.md
@@ -134,6 +134,6 @@ You can combine config with regular cli options. Evaluation occurs in this order
 3. config yaml (if present) value
 4. explicit cli value
 
-## Examples
+## Examples & FAQ
 
-[see examples.md](./examples.md)
\ No newline at end of file
+[examples.md](/examples.md), [FAQ](/faq.md)
\ No newline at end of file