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
32957	Make documentation of Model.save() arguments easier to find and get to	Chris Jerdonek	Abhyudai	"Currently, in the documentation of [https://docs.djangoproject.com/en/3.2/ref/models/instances/#saving-objects Model.save()], one needs to scroll far down to find documentation of the keyword arguments. For example, for the `update_fields` argument, one has to scroll down to a section called [https://docs.djangoproject.com/en/3.2/ref/models/instances/#specifying-which-fields-to-save ""Specifying which fields to save""].

I think it would be helpful if, right after `Model.save()`'s function signature in the docs, there was a sentence or two containing a link to the right section, for each keyword argument argument appearing in the signature. I'm thinking of sentences like, ""For documentation of the `force_insert` and `force_update` arguments, see the ""Forcing an INSERT or UPDATE"" section. ..."" This will make it clearer where the documentation for the arguments can be found.
"	Cleanup/optimization	closed	Documentation	dev	Normal	fixed			Ready for checkin	1	0	0	0	1	0