[DOCS] The examples of states.ssh_auth use the parameter "names" but this parameter is never explained in the doc

[iils-jschmidt]

Description
The examples of states.ssh_auth use the parameter "names" but this parameter is never explained in the doc.

Also, if the names parameter is used with a list of keys only the last one is added to the authorized_keys file.

So either the example is wrong or a description is missing.

Suggested Fix
Either rewrite the exmaples or include the names parameter in the state description.

Type of documentation
Salt documentation

Location or format of documentation
https://docs.saltproject.io/en/latest/ref/states/all/salt.states.ssh_auth.html

[welcome]

Hi there! Welcome to the Salt Community! Thank you for making your first contribution. We have a lengthy process for issues and PRs. Someone from the Core Team will follow up as soon as possible. In the meantime, here’s some information that may help as you continue your Salt journey.
Please be sure to review our Code of Conduct. Also, check out some of our community resources including:

• Community Wiki
• Salt’s Contributor Guide
• Join our Community Slack
• IRC on LiberaChat
• Salt Project YouTube channel
• Salt Project Twitch channel

There are lots of ways to get involved in our community. Every month, there are around a dozen opportunities to meet with other contributors and the Salt Core team and collaborate in real time. The best way to keep track is by subscribing to the Salt Community Events Calendar.
If you have additional questions, email us at saltproject@vmware.com. We’re glad you’ve joined our community and look forward to doing awesome things with you!

[whytewolf]

this is one of those things that needs to be better documented in the docs.

- names is actually a higher level function more akin to requisites. the documentation for it is at https://docs.saltproject.io/en/latest/ref/states/highstate.html#names-declaration