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
30688	Clarify docs for Options.base_manager_name.	Anton Gilgur	Anton Gilgur	"There is currently no documentation in topics or the reference about how ''specifically'' to use `Meta.base_manager_name` and I think an example could alleviate the confusion this causes.

I had some trouble in a library I maintain (https://github.com/agilgur5/django-serializable-model/issues/4#issuecomment-519338032), where I mistakenly thought that `base_manager_name` should be set to, ''literally'' the name of the manager, as in the string equivalent to the name of the class of the manager (in my case, `'SerializableManager'`), similar to how one may reference models by string.
Through finding some examples online like https://stackoverflow.com/a/48124863/3431180, I realized it's supposed to be the name of the attribute on the current class that contains the instance of the manager (in my case, `'objects'`).

An example would really clear things up very concisely."	Cleanup/optimization	closed	Documentation	dev	Normal	fixed			Accepted	1	0	0	1	0	0