You might want to include some :return: and :rtype: tags.