From a82ecbcbff0339a7e0395243196f17029e63cfef Mon Sep 17 00:00:00 2001
From: Johannes Kirschbauer <hsjobeki@gmail.com>
Date: Thu, 14 Aug 2025 18:01:19 +0200
Subject: [PATCH] docs: update docs for exports

---
 .../distributed-service/service-module.nix          | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/lib/modules/inventory/distributed-service/service-module.nix b/lib/modules/inventory/distributed-service/service-module.nix
index b8b30c3ca..250bc3971 100644
--- a/lib/modules/inventory/distributed-service/service-module.nix
+++ b/lib/modules/inventory/distributed-service/service-module.nix
@@ -635,14 +635,23 @@ in
     exports = mkOption {
       description = ''
         This services exports.
-        Gets merged with all other services exports
+        Gets merged with all other services exports.
 
-        Final value (merged and evaluated with other services) available as `exports` in the arguments of this module.
+        Exports are used to share and expose information between instances.
+
+        Define exports in the [`perInstance`](#perInstance) or [`perMachine`](#perMachine) scope.
+
+        Accessing the exports:
 
         ```nix
         { exports, ... }: {
           _class = "clan.service";
+
           # ...
+          roles.peer.perInstance = { exports, ...}: { ...};
+
+          # ...
+          perMachine = { exports, ...}: { ...};
         }
         ```
       '';