docs: Missing ``:yields:`` in info fields?

[pawamoy]

Describe the bug

Not a bug, but you don't have a "docs" issue template 🙂 Should I have opened this as a discussion instead?

Coming from mkdocstrings/mkdocstrings#790. It looks like :yields: is supported as an info field, but is not documented in https://www.sphinx-doc.org/en/master/usage/domains/python.html#info-field-lists.

[AA-Turner]

yield(s) doesn't appear in the list with the others, is it supported?

sphinx/sphinx/domains/python/_object.py

Lines 187 to 232 in e8ab5cf

	doc_field_types = [
	PyTypedField(
	'parameter',
	label=_('Parameters'),
	names=(
	'param',
	'parameter',
	'arg',
	'argument',
	'keyword',
	'kwarg',
	'kwparam',
	),
	typerolename='class',
	typenames=('paramtype', 'type'),
	can_collapse=True,
	),
	PyTypedField(
	'variable',
	label=_('Variables'),
	names=('var', 'ivar', 'cvar'),
	typerolename='class',
	typenames=('vartype',),
	can_collapse=True,
	),
	PyGroupedField(
	'exceptions',
	label=_('Raises'),
	rolename='exc',
	names=('raises', 'raise', 'exception', 'except'),
	can_collapse=True,
	),
	Field(
	'returnvalue',
	label=_('Returns'),
	has_arg=False,
	names=('returns', 'return'),
	),
	PyField(
	'returntype',
	label=_('Return type'),
	has_arg=False,
	names=('rtype',),
	bodyrolename='class',
	),
	]

A