From 084023c72af0071afc8d7a4476f267c328746693 Mon Sep 17 00:00:00 2001
From: Maximilian Bosch <maximilian@mbosch.me>
Date: Sat, 4 Jul 2026 12:00:54 +0200
Subject: [PATCH] nixos/matrix-authentication-service: fix formatting of
 description

Be more explicit in the first sentence. And use code-blocks to make sure
the code-example is rendered correctly.
---
 .../services/matrix/matrix-authentication-service.nix    | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/nixos/modules/services/matrix/matrix-authentication-service.nix b/nixos/modules/services/matrix/matrix-authentication-service.nix
index 978f2d571fde..18648d2e3451 100644
--- a/nixos/modules/services/matrix/matrix-authentication-service.nix
+++ b/nixos/modules/services/matrix/matrix-authentication-service.nix
@@ -379,13 +379,16 @@ in
       type = lib.types.attrsOf lib.types.str;
       default = { };
       description = ''
-        Name -> source file path. Exposed to the unit via LoadCredential and
-        readable inside the service at ''${CREDENTIALS_DIRECTORY}/<name>.
+        Mapping of credential name to  source file-path. Exposed to the unit via LoadCredential and
+        readable inside the service at `''${CREDENTIALS_DIRECTORY}/<name>`.
 
-        For example :
+        For example:
+
+        ```
         services.matrix-authentication-service.credentials."synapse-secret" = "/run/agenix/synapse-shared";
         services.matrix-authentication-service.settings.matrix.secret_file =
           "\''${CREDENTIALS_DIRECTORY}/synapse-secret";
+        ```
       '';
     };
   };