doc: improved documentation for ssh keys

src/tutorials/skynet/create_ssh.md

@@ -4,6 +4,9 @@ To be able to gain remote access to the Skynet.
 
 ``$USERNAME`` Refers to your Skynet username, for example I would replace ``$USERNAME`` with ``silver``
 
+## Windows
+If you are using Windows then you should use PowerShell, not ``cmd``.
+
 ## Prep
 First we set up the ssh folder and create a skynet folder within it for neatness
                 
@@ -14,14 +17,20 @@ cd ~/.ssh/skynet
 
 ## Create Key
 Now we will create the ssh key itself.
-Location: ``$USERNAME``, your skynet username.  
-**Password: Press Enter twice for no password on the key.**  
-
-If you are creating this key for a CI/CD pipeline (``user_deploy*``) then adding a password will cause it to fail.
 
 ```bash
 ssh-keygen -t ed25519 -C "<comment>"
 ```
+
+* ``<comment>``: this is a comment to yerself about what the key is for
+    * I often use ``username@host``, ``silver@skynet``.
+* Location: ``./$USERNAME``, your skynet username.
+    * ``./silver`` for example.
+* **Password: Press Enter twice for no password on the key.**  
+
+If you are creating this key for a CI/CD pipeline (``user_deploy*``) then adding a password will cause it to fail.
+
+
 It will create two files: ``$USERNAME`` and ``$USERNAME.pub`` inside ``~/.ssh/skynet``
 
 ### Linux Only