[Documentation] PSR12 - Boolean Operator Placement

[dingo-d]

The PR contains the documentation for the PSR12/ControlStructures/BooleanOperatorPlacement sniff.

Description

This PR will add the documentation for the above-mentioned sniff, according to the official standard definitions.

Suggested changelog entry

Add documentation for the PSR12 BooleanOperatorPlacement sniff

Related issues/external references

Part of #148

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
  • This change is only breaking for integrators, not for external standards or end-users.
• Documentation improvement

PR checklist

• I have checked there is no other PR open for the same change.
• I have read the Contribution Guidelines.
• I grant the project the right to include and distribute the code under the BSD-3-Clause license (and I have the right to grant these rights).
• I have added tests to cover my changes.
• I have verified that the code complies with the projects coding standards.
• [Required for new sniffs] I have added XML documentation for the sniff.

[jrfnl]

Thanks for this PR @dingo-d !

I've left a few suggestions inline which are optional.

However, the remark about the main description and the typo should definitely be addressed.

[jrfnl]

P.S.: Would you mind rebasing the PR before you continue work on it ? That should allow to get a passing build.

[dingo-d]

@jrfnl Before I rebase can you just check the change I made to the standard definition?

[jrfnl]

@jrfnl Before I rebase can you just check the change I made to the standard definition?

I'm fine with it as it is now.

For readability you could consider restructuring it a little like below, but that's up to you. Either way is fine by me.

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.

Aside from the "Invalid" description for the second code block, this is now good to go as far as I'm concerned.

[jrfnl]

Thanks again @dingo-d ! LGTM!