From c8be3a4e05c8957e099c8921bfcbfd93bb512285 Mon Sep 17 00:00:00 2001
From: Grim <69561145+LinkIsGrim@users.noreply.github.com>
Date: Tue, 18 Jun 2024 12:26:24 -0300
Subject: [PATCH] Docs - Clarifiy `!` operator usage in Coding Guidelines
 (#10080)

coding guidelines brackets
---
 docs/wiki/development/coding-guidelines.md | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/docs/wiki/development/coding-guidelines.md b/docs/wiki/development/coding-guidelines.md
index fcecbfbce4..fe9f0bfdf0 100644
--- a/docs/wiki/development/coding-guidelines.md
+++ b/docs/wiki/development/coding-guidelines.md
@@ -381,11 +381,19 @@ However the following is allowed:
 _value = (_array select 0) select 1;
 ```
 
-Any conditions in statements shall always be wrapped around brackets.
+Any conditions in statements shall always be wrapped around brackets. Both uses of the `!` operator below are allowed.
 
 ```sqf
-if (!_value) then {};
 if (_value) then {};
+if (!_value) then {};
+if !(_value) then {};
+```
+
+Use of the `!` operator on the lefthand-side of brackets can be more readable, particularly for more complex conditions or macros:
+
+```sqf
+if !(_value && _otherValue && {_thirdValue call _something}) then {};
+if !(GETEGVAR(addon,globalVariableName,defaultValue)) then {};
 ```
 
 ### 5.6 Magic Numbers