Improve documentation for `no_boolean_in_comparison`

[kivra-pauoli]

There are cases where we seem to be comparison about true/false for their value and not their implicit truthy nature. We should improve our doc.s to mention a few edge cases and how to solve them, taking as input the discussion starting from #448 (comment).