[New-bugs-announce] [issue46139] Boolean Logic Check - Built-in Types Documentation page

[Abri Vincent]

New submission from Abri Vincent <abriabrisham at gmail.com>:

On the documentation page https://docs.python.org/3/library/stdtypes.html the header 'Boolean Operations — and, or, not' provides a table (attached as an image). 

It states: 

a.1) x OR y - if x is false, then y, else x **
a.2) x AND y - if x is false, then x, else y **

When I read this i intuit the following

b.1) x OR y - if x is false, then x, else y
b.2) x AND y - if x is false, then y, else x

Providing an example with a.1 which is currently listed in the documentation

If x is false -> else x = False (we don't check if Y=True which is the definition of an OR operator). 

** This is a short-circuit operator, so it only evaluates the second argument if the first one is false.

I would appreciate clarification on this and if others see an issue with the documentation after reading my description able then movement on consensus to correct the documentation

----------
assignee: docs at python
components: Documentation
messages: 408972
nosy: abriabrisham, docs at python
priority: normal
severity: normal
status: open
title: Boolean Logic Check - Built-in Types Documentation page

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue46139>
_______________________________________