DOC: fixup docstring of deprecate_nonkeyword_arguments
See this comment from a previous pull request I submitted: https://github.com/pandas-dev/pandas/pull/41524#discussion_r634344743

Just need to add `, optional`, so opening as good first issue