id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
31720	Better documentation and defaults for BoolOr and BoolAnd	Alex Scott	David Chorpash	"The only documentation available (that I found at least) for Postgres DB functions is:
https://docs.djangoproject.com/en/3.0/ref/contrib/postgres/aggregates/

It would be really nice to have an example or two for each of those.

One issue I ran into with `BoolOr` when I was doing something like `BoolOr(Q('someCharField') == Value('someVal'))` (which in itself would be a great example to show), is an error:

`'Cannot resolve expression type, unknown output_field'`

Adding `output_field=BooleanField()` seemed to solve it but this wasn't intuitive.  Shouldn't the default output for `BoolOr` be boolean?  If so, it would be good to set it as such I think."	Cleanup/optimization	closed	Database layer (models, ORM)	3.0	Normal	fixed			Ready for checkin	1	0	0	0	0	0