"Prefer flags to args." could be misinterpreted

[ssokolow]

Prefer flags to args. It’s a bit more typing, but it makes it much clearer what is going on. It also makes it easier to make changes to how you accept input in the future. Sometimes when using args, it’s impossible to add new input without breaking existing behavior or creating ambiguity.

...

...

Multiple arguments are fine for simple actions against multiple files. For example, rm file1.txt file2.txt file3.txt. This also makes it work with globbing: rm *.txt.

Putting my novice hat on, I could easily see myself not connecting these two pieces of advice because of how far apart they are separated in the text and how the latter is neither a sub-point of the former nor using very strong phrasing for "this is an exception".

It'd probably be a good idea to tweak the phrasing of the first one.

Maybe something like this:

Prefer flags to args. Save args for when you have one primary input field that can be repeated, like a path or URL. It’s a bit more typing, but it makes it much clearer what is going on. It also makes it easier to make changes to how you accept input in the future. Sometimes when using args, it’s impossible to add new input without breaking existing behavior or creating ambiguity.