From 12dbeb99c38c5b0cf558294ae164ad13be31a613 Mon Sep 17 00:00:00 2001
From: Oliver Gugger <gugger@gmail.com>
Date: Fri, 9 May 2025 11:00:02 +0200
Subject: [PATCH] docs: document previously implicit formatting rule

Adds a formatting rule to the code style documentation that is being
used widely throughout the codebase but isn't properly documented.
---
 docs/development_guidelines.md | 42 ++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/docs/development_guidelines.md b/docs/development_guidelines.md
index 1ae7d92c2..df0c89421 100644
--- a/docs/development_guidelines.md
+++ b/docs/development_guidelines.md
@@ -230,6 +230,48 @@ value, err := bar(
 )
 ```
 
+As long as the visual symmetry of the opening and closing parentheses is
+preserved, arguments that would otherwise introduce a new level of indentation
+are allowed to be written in a more compact form.
+
+Example with inline struct creation:
+
+**ACCEPTABLE**
+```go
+	response, err := node.AddInvoice(
+		ctx, &lnrpc.Invoice{
+			Memo:      "invoice",
+			ValueMsat: int64(oneUnitMilliSat - 1),
+		},
+	)
+```
+
+**PREFERRED**
+```go
+	response, err := node.AddInvoice(ctx, &lnrpc.Invoice{
+		Memo:      "invoice",
+		ValueMsat: int64(oneUnitMilliSat - 1),
+	})
+```
+
+Example with nested function call:
+
+**ACCEPTABLE**:
+```go
+	payInvoiceWithSatoshi(
+		t.t, dave, invoiceResp2, withFailure(
+			lnrpc.Payment_FAILED, failureNoRoute,
+        ),
+    )
+```
+
+**PREFERRED**:
+```go
+	payInvoiceWithSatoshi(t.t, dave, invoiceResp2, withFailure(
+		lnrpc.Payment_FAILED, failureNoRoute,
+	))
+```
+
 #### Exception for log and error message formatting
 
 **Note that the above guidelines don't apply to log or error messages.** For