From 787fb83834b66fa19014feacb92af6f77af101a6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Denis=20=C5=BDoljom?= <dingo-d@users.noreply.github.com>
Date: Sat, 23 Dec 2023 10:52:37 +0100
Subject: [PATCH] Add the documentation for the PSR12 Boolean Operator
 Placement sniff

Co-authored-by: Juliette <663378+jrfnl@users.noreply.github.com>
---
 .../BooleanOperatorPlacementStandard.xml      | 59 +++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 src/Standards/PSR12/Docs/ControlStructures/BooleanOperatorPlacementStandard.xml

diff --git a/src/Standards/PSR12/Docs/ControlStructures/BooleanOperatorPlacementStandard.xml b/src/Standards/PSR12/Docs/ControlStructures/BooleanOperatorPlacementStandard.xml
new file mode 100644
index 0000000000..805e15c660
--- /dev/null
+++ b/src/Standards/PSR12/Docs/ControlStructures/BooleanOperatorPlacementStandard.xml
@@ -0,0 +1,59 @@
+<documentation title="Boolean Operator Placement">
+    <standard>
+    <![CDATA[
+    Boolean operators between conditions in control structures must always be at the beginning or at the end of the line, not a mix of both.
+
+    This rule applies to if/else conditions, while loops and switch/match statements.
+    ]]>
+    </standard>
+    <code_comparison>
+        <code title="Valid: Boolean operator between conditions consistently at the beginning of the line.">
+        <![CDATA[
+if (
+    $expr1
+    && $expr2
+    && ($expr3
+    || $expr4)
+    && $expr5
+) {
+    // if body.
+}
+        ]]>
+        </code>
+        <code title="Invalid: Mix of boolean operators at the beginning and the end of the line.">
+        <![CDATA[
+if (
+    $expr1 &&
+    ($expr2 || $expr3)
+    && $expr4
+) {
+    // if body.
+}
+        ]]>
+        </code>
+    </code_comparison>
+    <code_comparison>
+        <code title="Valid: Boolean operator between conditions consistently at the end of the line.">
+        <![CDATA[
+if (
+    $expr1 ||
+    ($expr2 || $expr3) &&
+    $expr4
+) {
+    // if body.
+}
+        ]]>
+        </code>
+        <code title="Invalid: Mix of boolean operators at the beginning and the end of the line.">
+        <![CDATA[
+match (
+    $expr1
+    && $expr2 ||
+    $expr3
+) {
+    // structure body.
+};
+        ]]>
+        </code>
+    </code_comparison>
+</documentation>