Update README.md

As per discussion on https://www.reddit.com/r/Puppet/comments/14b5xrc/adding_a_comment_line_for_ssh_authorized_key/ it was felt it wasn't obvious the the name would be applied as the comment without looking through docs more. Updating example to be closer to the references example which explicitly shows this

Author: davidsandilands

README.md

@@ -33,6 +33,11 @@ ssh_authorized_key { 'nick@magpie.example.com':
 }
 ```
 
+This would create a key that appears in your ~/.ssh/id_rsa.pub file like this with resource name as comment:
+```
+ssh-rsa AAAAB3Nza[...]qXfdaQ== nick@magpie.example.com
+```
+
 To manage a known hosts file entry, use the following code:
 
 ```