From e9cbfb79fb14e11d69a4c15c2d451f26d67c7c4c Mon Sep 17 00:00:00 2001
From: Sridhar Ratnakumar <srid@srid.ca>
Date: Mon, 21 Oct 2024 13:48:58 -0400
Subject: [PATCH] chore: Add comment explaining this approach

---
 nix/process-compose/default.nix | 1 +
 1 file changed, 1 insertion(+)

diff --git a/nix/process-compose/default.nix b/nix/process-compose/default.nix
index 0b37370..a61c422 100644
--- a/nix/process-compose/default.nix
+++ b/nix/process-compose/default.nix
@@ -44,6 +44,7 @@ in
           text = ''
             ${config.cli.preHook}
 
+            # IMPORTANT: We **must** use environment variables for everything but non-global options, otherwise the use of sub-command specific CLI options will prevent the user from passing their own subcommands reliably.
             set -x
             ${config.cli.outputs.environment} PC_CONFIG_FILES=${configFile} process-compose ${config.cli.outputs.options} "$@"
             set +x