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
25159	Remove brackets from method/function signatures in docs	Tim Graham	Tim Graham	"According to the [http://sphinx-doc.org/domains.html?highlight=function#signatures spinx docs], ""For functions with optional parameters that don’t have default values (typically functions implemented in C extension modules without keyword argument support), you can use brackets to specify the optional parts"". Not sure how our docs got in the habit of using brackets, but it doesn't seem like we should be doing that.

Brackets should be removed from things like:

`.. function:: create_test_db([verbosity=1, autoclobber=False, serialize=True, keepdb=False])`

and missing kwarg defaults should be added in places like:

`.. function:: password_reset_confirm(request[, uidb64, token, template_name, token_generator, set_password_form, post_reset_redirect, current_app, extra_context])`


Find the places to update with `grep -rI ""\["" * | grep 'function::'` and `grep -rI ""\["" * | grep 'method::'`."	Cleanup/optimization	closed	Documentation	1.8	Normal	fixed			Accepted	1	0	0	0	1	0