I made a PR there: https://github.com/JuliaLang/julia/issues/37468
And noticed that the Mathematical Operators section was already updated some months ago to include the definition of Boolean operators before the bitwise ones, which is probably enough to avoid misunderstandings. The change is only still not yet the published version of the docs.