From fd0902e67a84d13a1d6b1a754170e72a26766020 Mon Sep 17 00:00:00 2001
From: vdbe <44153531+vdbe@users.noreply.github.com>
Date: Fri, 23 Aug 2024 12:20:38 +0000
Subject: [PATCH] docs: add IFD FAQ (#246)

* docs: add IFD FAQ

* docs: mirror IFD FAQ to docs

* docs: reword IFD FAQ to those ports

* chore: update IFD list

* chore: remove dunst from IFD list

The IFD from dunst was removed in #302

* docs: FAQ IFD apply suggestions

* docs: FAQ IFD add spotify-player

* docs: cleanup IFD module code example

Seems spotify-player doesn't required IFD either as it's source is from
a builtin

---------

Co-authored-by: seth <getchoo@tuta.io>
---
 README.md       | 23 +++++++++++++++++++++++
 docs/src/faq.md | 23 +++++++++++++++++++++++
 2 files changed, 46 insertions(+)

diff --git a/README.md b/README.md
index 8c50498..19d4bf9 100644
--- a/README.md
+++ b/README.md
@@ -173,6 +173,29 @@ For [standalone installations](https://nix-community.github.io/home-manager/inde
   A: We primarily support the `unstable` branch, but try our best to support the current stable release.
   You can check if your stable release is currently supported at [status.nixos.org](https://status.nixos.org/)
 
+- Q: **"How do I fix the error: ... during evaluation because the option 'allow-import-from-derivation' is disabled"**\
+  A: Some ports need to read and/or manipulate remote resources, resulting in Nix performing [IFD](https://nix.dev/manual/nix/latest/language/import-from-derivation).
+
+  <details>
+  <summary>Disable modules that use IFD</summary>
+  
+  ```nix
+  {
+    programs = {
+      cava.catppuccin.enable = false;
+      gh-dash.catppuccin.enable = false;
+      imv.catppuccin.enable = false;
+      kitty.catppuccin.enable = false; # IFD is introduced by home-manager
+      swaylock.catppuccin.enable = false;
+    };
+  
+    services = {
+      mako.catppuccin.enable = false;
+    };
+  }
+  ```
+  </details>
+
 ## 💝 Thanks to
 
 - [Stonks3141](https://github.com/Stonks3141)
diff --git a/docs/src/faq.md b/docs/src/faq.md
index ab8f1a3..1f0d304 100644
--- a/docs/src/faq.md
+++ b/docs/src/faq.md
@@ -10,3 +10,26 @@
 - Q: **"What versions of NixOS and home-manager are supported?"**\
   A: We primarily support the `unstable` branch, but try our best to support the current stable release.
   You can check if your stable release is currently supported at [status.nixos.org](https://status.nixos.org/)
+
+- Q: **"How do I fix the error: ... during evaluation because the option 'allow-import-from-derivation' is disabled"**\
+  A: Some ports need to read and/or manipulate remote resources, resulting in Nix performing [IFD](https://nix.dev/manual/nix/latest/language/import-from-derivation).
+
+  <details>
+  <summary>Disable modules that use IFD</summary>
+  
+  ```nix
+  {
+    programs = {
+      cava.catppuccin.enable = false;
+      gh-dash.catppuccin.enable = false;
+      imv.catppuccin.enable = false;
+      kitty.catppuccin.enable = false; # IFD is introduced by home-manager
+      swaylock.catppuccin.enable = false;
+    };
+  
+    services = {
+      mako.catppuccin.enable = false;
+    };
+  }
+  ```
+  </details>