improve method documentation