[*.py] Rename "Arguments:" to "Args:"

[SamuelMarks]

I've written custom parsers and emitters for everything from docstrings to classes and functions. However, I recently came across an issue with the TensorFlow codebase: inconsistent use of Args: and Arguments: in its docstrings. It is easy enough to extend my parsers to support both variants, however it looks like Arguments: is wrong anyway, as per:

• https://google.github.io/styleguide/pyguide.html#doc-function-args @ ddccc0f

• https://chromium.googlesource.com/chromiumos/docs/+/master/styleguide/python.md#describing-arguments-in-docstrings @ 9fc0fc0

• https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html @ c0ae8e3

Therefore, only Args: is valid. This PR replaces them throughout the codebase.

PS: For related PRs, see tensorflow/tensorflow/pull/45420

[SamuelMarks]

Again, only accept the change on this line if keras-team/keras-contrib#550 is accepted (oh, and change to docstring.replace("Args:", "# Args"))

[fchollet]

As a general convention, use fully-spelled out names rather than abbreviations, since it is more user-friendly. "Args" is not a dictionary word. We could simply standardize on "Arguments".

[SamuelMarks]

@fchollet As a general convention following the formal specification is recommended; to take your advice to its logical extreme, using function_definition rather than def in Python code would be warranted! In this circumstance though, there is no formal specification, however the references shown from Google indicates official use of Args:—rather than Arguments:—and sphinx is following suite.

Although args is not an English word, it is used throughout the Python codebase, e.g., ast.FunctionDef. Also arg is [sometimes] a dictionary word (Merriam Webster, wiktionary).

Standardising is a good idea. You can get Google to change their style guide to accept Arguments: as valid, or [as I'd recommend] you can accept this PR.

(keras-io#a21a7f8)$ for name in 'Args:' 'Arguments:'; do
     printf '%-10s %04d\n' "$name" "$(rg -IFtpy --count-matches "$name" | paste -s -d+ -- | bc)"; done
Args:      0008
Arguments: 0015

[SamuelMarks]

@fchollet Did you see my comment? - Happy to merge master and redo sed (or fastmod -F)…