So far, the approach has been:

def some_method(self, arg1, arg2):
	"""The one-line description of the method.

	Args:
		arg1: Description
		arg2: Description

	Returns:
		What this returns (if anything)
	"""
	# Begin implementation
	return something

I am open to new suggestions as long as we are standardized. numpydoc seems reasonable, interested to hear other opinions.

Looks like numpydoc has a standard extension in sphinx, which will make the cross-reference easier.

numpydoc is a good testable standard. Let's go with that. We can install pydocstyle and test from bash with

pydocstyle --convention=numpy modin/pandas