I don't believe that would improve the docs, but suit yourself.  This is hardly a FAQ, but instead a peculiar case where, for whatever reason, someone is saying "I'm puzzled by what `or` does, but didn't read the docs for `or`".  Most people confused by `or` almost certainly _do_ read the docs for `or` ;-)

As is, in the precedence table the word "or" is already a direct hyperlink to the section _about_ "or", and similarly for "and".  It can't be made any easier than that to find the whole story.

If you do want to pursue adding more cruft to the docs, note that the same would be needed for the `- if - else -` operator too.