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