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