From ded9be67741d14befc319f6cb5ed46f8c15861b4 Mon Sep 17 00:00:00 2001
From: steve-chavez <stevechavezast@gmail.com>
Date: Mon, 22 Jun 2026 12:55:56 -0500
Subject: [PATCH] nix(loadtest): add comment on loadtest-against

---
 nix/tools/loadtest.nix | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/nix/tools/loadtest.nix b/nix/tools/loadtest.nix
index 2130bf1a7..0e08c9c75 100644
--- a/nix/tools/loadtest.nix
+++ b/nix/tools/loadtest.nix
@@ -192,6 +192,9 @@ let
             Run the vegeta loadtest against every target branch and HEAD:
             - once on the every <target-#> branch
             - once in the current worktree
+
+            Note that the Nix tooling is always taken from the HEAD branch, while the PostgREST binary is taken from the target branch.
+            For a discussion on why this is set up like this, see https://github.com/PostgREST/postgrest/pull/5013#discussion_r3431508441.
           '';
         args = [
           "ARG_POSITIONAL_INF([target], [Commit-ish reference to compare with], 1)"