﻿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
27392	"Remove ""Tests that"", ""Ensures that"", etc. from test docstings"	Tim Graham	Harshit Agrawal	"Our policy is for test docstrings to state the expected behavior that each test demonstrates. Preambles such as ""Tests that"" or ""Ensures that"" aren't necessary.

Good: ""Horizontal and vertical filter widgets keep selected options on page reload.""
Bad: ""Tests that horizontal and vertical..."".

For example:

$ grep -rI ""Tests that"" * | wc -l
158
$ grep -rI ""Test that"" * | wc -l
222
$ grep -rI ""Ensure that"" * | wc -l
173
$ grep -rI ""Ensures that"" * | wc -l
14

If you spot any other similar patterns, please correct them. The policy should also be added to `docs/internals/contributing/writing-code/coding-style.txt`."	Cleanup/optimization	closed	Documentation	dev	Normal	wontfix		reinout@… diogo.monteiro12@…	Accepted	0	0	0	0	1	0
