updating git 101

Author: Tom-Fynes

docusaurus.config.js

@@ -34,6 +34,11 @@ const config = {
     ],
   ],
 
+  themes: ["@docusaurus/theme-mermaid"],
+  markdown: {
+    mermaid: true,
+  },
+
   presets: [
     [
       "classic",

git_101/Grade 1/git_clone.md

@@ -0,0 +1,74 @@
+---
+id: Git Clone
+sidebar_position: 5
+---
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+Instead of starting a new project from scratch, you can use Git to clone an existing repository — copying all its files, branches, and history to your local machine.
+
+This is one of the most common ways to start working on a project that’s hosted on GitHub or another remote platform.
+
+## What does `Git clone` do
+
+Actions of the git clone command are as follows:
+
+* Creates a local copy of a remote repository.
+
+* Automatically sets up the connection to the remote (`origin`).
+
+* Downloads all branches and commit history.
+
+**Example**
+
+```bash
+git clone <repository-url>
+```
+
+## Clone Your First Repository 
+
+1. Open a terminal or command prompt.
+
+2. Navigate to the folder where you want to download the repo:
+```bash
+cd projects  # or any other directory
+```
+3. Run the clone command:
+```bash
+git clone https://github.com/Tom-Fynes/git-101
+```
+
+4. You should see output like:
+``` vbnet
+Cloning into 'git-101'...
+remote: Enumerating objects: ...
+remote: Counting objects: ...
+Receiving objects: ...
+Resolving deltas: ...
+```
+
+5. Now check your files:
+    * Change directory to newly cloned repo
+```bash
+cd git-101
+```
+
+    * List all files and folders in directoy 
+
+<Tabs>
+  <TabItem value="Windows" label="windows" default>
+    ```bash
+        dir
+    ```
+  </TabItem>
+  <TabItem value="MacOs" label="Mac">
+    ```bash
+        ls
+    ```
+  </TabItem>
+  <TabItem value="Linux" label="linux">
+    ```bash
+        ls
+    ```
+  </TabItem>
+</Tabs>

git_101/Grade 1/git_init.md

@@ -14,14 +14,15 @@ Once initialized, Git will start tracking changes in that folder — but only fo
 ## Create Your First Repository 
 
 1. Open your terminal
-2. Navigate to the `git-101` folder created at the start of this course
-    * if you mised this step please see [here](/git_101/intro) 
+2. Navigate to a directory where you will keep your repo's
+    * IF you don't have one I like to use **projects**:  `mkdir projects`
 ```bash
-cd git-101
+cd  projects
 ```
+
 3. Initialize the repository:
 ```bash
-git init
+git init git-demo
 ```
 
 4. You should see: 

git_101/Grade 2/git_workflow.md

@@ -0,0 +1,39 @@
+---
+id: Understanding the Git Workflow
+sidebar_position: 1
+---
+
+
+To use `Git` effectively, it’s important to understand the workflow which is broken into three parts:
+
+* Working Directory
+
+* Staging Area (Index)
+
+* HEAD (Repository)
+
+These components work together to track, orgernise, and save changes.
+
+## Working Directory
+
+This is the current state of your project, the files and folders you’re actively editing.
+
+Anything you create, modify, or delete here is considered unstaged by `Git`.
+
+## Staging Area
+
+The Staging Area is like a clipboard or checklist of changes you want to include in your next commit, you add files from your working directory to the staging area by using the `git add` command.
+
+
+## HEAD (Repository)
+
+The `HEAD`, is the permanent history of commits. Each commit is a snapshot of the files that were staged at the time. Files are added to this area by using the `git commit` command.
+
+## Visualizing the Git Workflow
+
+```mermaid
+flowchart LR
+    A[Working Directory] -->|Git add| B[Staging Area]
+    B -->|Git commit| C[HEAD - Repository]
+    C -->|checkout| A
+```

git_101/intro.md

@@ -11,20 +11,6 @@ If you like this course and want to support the project, you can do so here:
 
 [![Support me on Ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/tomfynes)
 
-## 🛠️ Setup Instructions
-
-**Create a working directory:**
-
-```bash
-mkdir git-101
-```
-
-
-**Navigate to the Directory:**
-
-```bash
-cd git-101
-```
 
 ## Grades
 
@@ -45,11 +31,11 @@ cd git-101
 
 * [**Git init**](/git_101/Grade%201/Git%20Init): Initializing a repository with `git init`.
 
-* Git clone: Cloning an existing repository with `git clone`.
+* [**Git clone**](/git_101/Grade%201/Git%20Clone): Cloning an existing repository with `git clone`.
 
 ### Grade 2: Basic Git Workflow
 
-* Understanding the Git Workflow: Working Directory, Staging Area, and Repository.
+* [**Understanding the Git Workflow**](/git_101/Grade%202/Understanding%20the%20Git%20Workflow): Working Directory, Staging Area, and Repository.
 
 * Adding files to staging with `git add`.
 
@@ -125,7 +111,7 @@ cd git-101
 
 * Applying specific commits with `git cherry-pick`.
 
-* Rewriting commit history with g`it rebase`.
+* Rewriting commit history with git rebase`.
 
 
 ### Grade 7: Troubleshooting and Optimization