Merge branch 'main' of https://github.com/JSK-KML/Python-Programming

Author: Aiman-Haris

.github/workflows/deploy.yml

@@ -26,6 +26,11 @@ jobs:
 
       - name: Install dependencies
         run: npm ci
+        env:
+          # CI only builds the VitePress site; it never generates PDFs,
+          # so skip Puppeteer's Chrome download (it can't reach Google's
+          # servers from the runner and would fail the install).
+          PUPPETEER_SKIP_DOWNLOAD: true
 
       - name: Build VitePress
         run: npm run docs:build

docs/.vitepress/config.mjs

@@ -37,7 +37,6 @@ export default defineConfig({
       {
         text: 'Tutorials',
         items: [
-          { text: 'Tutorial 0', link: '/tutorials/chapter-2-tutorial-0' },
           { text: 'Tutorial 1', link: '/tutorials/chapter-2-tutorial-1' },
           // { text: 'Tutorial 2', link: '/tutorials/chapter-2-tutorial-2' },
           // { text: 'Tutorial 3', link: '/tutorials/chapter-3-tutorial-3' },
@@ -149,10 +148,6 @@ export default defineConfig({
       ],
 
       '/tutorials/': [
-        {
-          text: 'Tutorial 0',
-          link: '/tutorials/chapter-2-tutorial-0'
-        },
         {
           text: 'Tutorial 1',
           link: '/tutorials/chapter-2-tutorial-1'

docs/index.md

@@ -7,9 +7,6 @@ hero:
   name: "CP115"
   text: "Python Programming"
   tagline: Labs, tutorials, and everything you need to get through the course.
-  image:
-    src: /icon.png
-    alt: CP115
   actions:
     - theme: brand
       text: Get Started

docs/labs/lab-01.md

@@ -27,6 +27,45 @@ This lab walks you through setting up **Git** and **VS Code**, then using their
 
 
 
+## Create a GitHub Account
+
+**GitHub** is the online platform where we store and share all the code for this course. Before you can fork, clone, or push any code, you need your own free **GitHub** account.
+
+<Badge type="tip" text="Task" />
+
+1. Open your browser and go to [https://github.com/signup](https://github.com/signup).
+2. Enter your **email address**. Use an email you check regularly so you can verify your account.
+3. Create a strong **password** and choose a **username**. This username is how others will see you on **GitHub**, so pick something clear and professional.
+
+
+Once your account is created and verified, you are ready to continue.
+
+## Preparing Your Workspace Folder
+
+Before working with **GitHub**, you need a place on your computer to keep your work. Keeping everything in one organized folder makes your files easy to find later.
+
+<Badge type="tip" text="Task" />
+
+First, create a folder named after yourself on your **Desktop**:
+
+1. Go to your **Desktop**.
+2. Right-click on an empty area and choose `New` → `Folder`.
+3. Name the folder using your own name, for example `aiman-cp115`.
+
+<br>
+
+Now open that folder in **VS Code** so it becomes your working area:
+
+1. Open **VS Code**.
+2. From the top menu, click `File` → `Open Folder...`.
+3. Browse to your **Desktop**, select the folder you just created, and click `Select Folder`.
+
+::: tip
+You can also open the folder directly by right-clicking it on the **Desktop** and choosing `Open with Code`.
+:::
+
+Once the folder is open, you will see its name at the top of the **Explorer** panel on the left side of **VS Code**. This is where your cloned repository will live.
+
 ## Install GitHub CLI
 
 **GitHub CLI** (`gh`) is a command-line tool that brings **GitHub** directly into your terminal. In this course, we use it to authenticate your machine with **GitHub** so that pushing and pulling code works without entering your credentials every time.
@@ -113,6 +152,24 @@ Back in **VS Code**, choose `Source Control` from the sidebar and click `Clone r
     <img src="/public/labs/lab-01/lab-1-4.png" alt="drawing" width="400"/>
 </p>
 
+### Cloning Using the Terminal <Badge type="tip" text="Optional" />
+
+Instead of the graphical `Source Control` panel, you can also clone the repository using the **terminal**. This is the method most programmers use, and it is good to get familiar with it.
+
+Open a terminal in **VS Code** by clicking `Terminal` and then `New Terminal`. A terminal will appear at the bottom of the window, already pointing at your workspace folder.
+
+In the terminal, type the command below, replacing the link with the one you copied from the `Code` button on **GitHub**:
+
+```bash
+git clone https://github.com/YOUR-USERNAME/CP115-Class-Repo.git
+```
+
+Press `Enter`, and **Git** will download a full copy of the repository into a new folder inside your workspace. 
+
+::: tip
+Both methods do the same thing. The `Source Control` panel runs the `git clone` command for you behind the scenes.
+:::
+
 After finishing that, your local copy is ready to use. If you have completed the **GitHub CLI** setup earlier, your machine is already authenticated and you are good to go.
 
 ## Commit and Push