docs: clarify usage of option with multiple values #2387

Job	Run time
test-redistribute (typer-cli)	11s
test-redistribute (typer-slim)	1m 29s
test-redistribute (typer)	1m 22s
test-redistribute-alls-green	3s
	3m 5s

Provide feedback