Update 03-install-ssh-and-clone.md

Signed-off-by: Thomas Pichler <54631167+PichlerThomas@users.noreply.github.com>

Author: PichlerThomas

web4-env-setup/install/windows/03-install-ssh-and-clone.md

@@ -1,120 +1,64 @@
-# Step 3: Install Git Bash, Set Up SSH Key, and Clone the Repository
-
-## 1. Install Git Bash
-
+Step 2: Install Git Bash, Set Up SSH Key, and Clone the Repository
+1. Install Git Bash
 Git Bash is a command-line shell for Windows that provides Git and Unix commands.
 
-- Download Git Bash here:  
-  [https://git-scm.com/downloads](https://git-scm.com/downloads)
-- Run the installer and follow the setup instructions.
-- After installation, open Git Bash (e.g., from the Start menu).
+Download Git Bash from the official website:
+https://git-scm.com/downloads
 
-## 2. Generate SSH Key and Start SSH Agent
+Run the installer and follow the setup instructions.
 
-SSH keys allow secure authentication with GitHub without entering your password every time.
+After installation, open Git Bash (e.g. from the Start menu).
 
-### 2.1 Check for existing SSH keys
+2. Generate SSH Key and Start SSH Agent
+SSH keys allow secure authentication with GitHub without typing your password every time.
 
+2.1 Check for existing SSH keys
 Open Git Bash and run:
 
-```bash
-ls ~/.ssh
-
-If you see files like id_ed25519 and id_ed25519.pub, you already have an SSH key. If not, continue to step 2.2.
+<pre> ls ~/.ssh </pre>
+If you see files like id_ed25519 and id_ed25519.pub, you already have an SSH key and can skip to step 2.4.
+If you don’t, continue with the next step.
 
 2.2 Generate a new SSH key
-Create a new SSH key using the recommended Ed25519 algorithm:
+Run this command to create a new SSH key using the Ed25519 algorithm:
 
-bash
-Kopieren
-Bearbeiten
-ssh-keygen -t ed25519 -C "your.email@example.com"
-Press Enter to accept the default file location (/c/Users/YourUsername/.ssh/id_ed25519).
-
-Optionally enter a passphrase for added security, or press Enter to leave it empty.
+<pre> ssh-keygen -t ed25519 -C "your_email@example.com" </pre>
+Press Enter to accept the default file location, then (optionally) enter a secure passphrase.
 
 2.3 Start the SSH agent
-Start the SSH agent which manages your keys:
+Start the SSH agent in the background with:
 
-bash
-Kopieren
-Bearbeiten
-eval "$(ssh-agent -s)"
+<pre> eval "$(ssh-agent -s)" </pre>
 2.4 Add your SSH key to the agent
-Add the SSH private key you just created to the agent:
-
-bash
-Kopieren
-Bearbeiten
-ssh-add ~/.ssh/id_ed25519
-2.5 Copy your public SSH key
-Display your public SSH key and copy its entire content:
-
-bash
-Kopieren
-Bearbeiten
-cat ~/.ssh/id_ed25519.pub
-It should look like this:
-
-bash
-Kopieren
-Bearbeiten
-ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIK2ohzmAhDaTtegkkRluKcpXo2ecGlLOV/pCFbprh5Ro your.email@example.com
-3. Add the SSH key to your GitHub account
-Log in to GitHub: https://github.com
+Now add your private key to the agent:
 
-Click on your profile picture (top-right) → Settings
+<pre> ssh-add ~/.ssh/id_ed25519 </pre>
+You should see confirmation like:
 
-Select SSH and GPG keys from the sidebar
+Identity added: /c/Users/YOUR_NAME/.ssh/id_ed25519 (your_email@example.com)
 
-Click New SSH key
+3. Add the SSH key to your GitHub account
+Copy the contents of your public key file:
 
-Give your key a descriptive title (e.g., "My Laptop")
+<pre> cat ~/.ssh/id_ed25519.pub </pre>
+Go to GitHub > Settings > SSH and GPG keys
 
-Paste your copied public SSH key into the "Key" field
+Click New SSH key, give it a name (e.g. "My Laptop")
 
-Click Add SSH key
+Paste the key into the "Key" field and click Add SSH key
 
 4. Test your SSH connection to GitHub
-Run:
-
-bash
-Kopieren
-Bearbeiten
-ssh -T git@github.com
-You should see a message like:
-
-vbnet
-Kopieren
-Bearbeiten
-Hi YourGitHubUsername! You've successfully authenticated, but GitHub does not provide shell access.
-5. Clone the repository
-Now you can clone the repository:
-
-bash
-Kopieren
-Bearbeiten
-git clone git@github.com:Cerulean-Circle-GmbH/WODA.2023.git
-This will download the repository into your current folder.
-
-Summary of important commands
-bash
-Kopieren
-Bearbeiten
-# Generate SSH key
-ssh-keygen -t ed25519 -C "your.email@example.com"
-
-# Start SSH agent
-eval "$(ssh-agent -s)"
-
-# Add SSH key to agent
-ssh-add ~/.ssh/id_ed25519
-
-# Show public SSH key
-cat ~/.ssh/id_ed25519.pub
-
-# Test GitHub SSH connection
-ssh -T git@github.com
-
-# Clone repository
-git clone git@github.com:Cerulean-Circle-GmbH/WODA.2023.git
+Verify everything is working:
+
+<pre> ssh -T git@github.com </pre>
+You should see:
+
+Hi USERNAME! You've successfully authenticated, but GitHub does not provide shell access.
+
+5. Clone the Repository
+Now that SSH is set up, you can clone the repository:
+
+<pre> git clone git@github.com:Cerulean-Circle-GmbH/WODA.2023.git </pre>
+You should see output like:
+
+<pre> Cloning into 'WODA.2023'... remote: Enumerating objects: ... ... Resolving deltas: ... </pre>