Comment 4 for bug 1569019

This is misleading and dangerous:

"SSH keys allow authentication between two hosts without the need of a password."

and should not be the first thing to show readers for how to use SSH.

"During the process you will be prompted for a password. Simply hit Enter when prompted to create the key."

I read that incorrectly. I read it like "Simply hit Enter when prompted to create the password." Probably because there is no single Enter to use when creating an SSH key and because of the earlier sentence. That should be changed to explain the actual dialog that occurs.

So I recommend the following change:

1. "You should now be able to SSH to the host. Enter the password you used during the key creation process."

Extend it to include ssh-agent:

2. "If you do not want to enter your password for every connection consider using ssh-agent." And then go on to explain how that works and how to implement it.

Basically this entire section should be reviewed.