docs: clarify usage of option with multiple values #2386

Job	Run time
test-redistribute (typer-slim)	1m 25s
test-redistribute (typer)	1m 28s
test-redistribute (typer-cli)	12s
test-redistribute-alls-green	4s
	3m 9s

Provide feedback