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
34071	Unclear validator messages for Range(Min/Max)ValueValidator compared to docs.	Jack Linke	Jack Linke	"The wording in the documentation for {{{ RangeMaxValueValidator }}} and {{{ RangeMinValueValidator }}} is very clear:

{{{#!python
""Validates that the upper bound of the range is not greater than limit_value.""
""Validates that the lower bound of the range is not less than the limit_value.""
}}}

[https://github.com/django/django/blob/0dd29209091280ccf34e07c9468746c396b7778e/docs/ref/contrib/postgres/validators.txt]

The wording in the validator messages (and validator test messages) within the code itself is somewhat confusing in comparison:

{{{#!python
""Ensure that this range is completely less than or equal to %(limit_value)s.""
""Ensure that this range is completely greater than or equal to %(limit_value)s.""
}}}

[https://github.com/django/django/blob/0dd29209091280ccf34e07c9468746c396b7778e/django/contrib/postgres/validators.py]
[https://github.com/django/django/blob/0dd29209091280ccf34e07c9468746c396b7778e/tests/postgres_tests/test_ranges.py]

Recommending a patch to modify the messages in the validator (and validator test) code to match the documentation, making it more clear to users exactly what the range validators do.

----

Patch 16146 on Django's GitHub PR tracker should resolve this. [https://github.com/django/django/pull/16146]"	Cleanup/optimization	closed	contrib.postgres	dev	Normal	fixed	postgres, range, validator, validators		Ready for checkin	1	0	0	0	1	0