From 9551c1dbc170193d2cf59b3bc6648a59b536ad7d Mon Sep 17 00:00:00 2001
From: Robert Hensing <robert@roberthensing.nl>
Date: Sun, 1 Oct 2023 13:34:27 +0100
Subject: [PATCH] transposition: Improve doc

---
 modules/transposition.nix | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/modules/transposition.nix b/modules/transposition.nix
index a89b9c8..7e985ba 100644
--- a/modules/transposition.nix
+++ b/modules/transposition.nix
@@ -31,6 +31,13 @@ in
       description = ''
         A helper that defines transposed attributes in the flake outputs.
 
+        When you define `transposition.foo = { };`, definitions are added to the effect of (pseudo-code):
+
+        ```nix
+        flake.foo.''${system} = (perSystem system).foo;
+        perInput = system: inputFlake: inputFlake.foo.''${system};
+        ```
+
         Transposition is the operation that swaps the indices of a data structure.
         Here it refers specifically to the transposition between