ITAI_ML_FirstRepo_Turing_Collective

ITAI-1371 — Classic Machine Learning · HCC Team ML_1371_14274-4: Shareefah Adeola-Ogunwolu · Joseph Clay · Alexander Debusk · Yilin Leng

---

📌 The Assignment

Add one line to hello_ml.txt — but you must do it through your own branch and your own pull request.

Hello from [Your Full Name]

⚠️ The instructor grades your branch, your commit, and your merged PR. If someone else types your name in for you, you get zero credit.

---

📚 Pick Your Route — Two Guides Are In This Repo

You do not need both. Pick whichever matches how you want to work.

If you...	Use this guide	What it covers
Have VS Code, Cursor, or another IDE and are comfortable with a terminal	Collaborative_Git_Playbook.pdf	Clone, branch, commit, push, and open a PR using git commands locally
Would rather not install anything or touch a terminal	Turing_Collective_Visual_GitHub_Guide.pptx	The same assignment done entirely in the GitHub browser — fork, edit, and open a PR by clicking

Both routes end the same way: your own branch, your own commit, your own merged pull request. The instructor grades the Git history, not which tool produced it.

Not sure which? If you have never used a terminal before and the deadline is close, take the browser route. It is fully valid and there is nothing to install.

The command sections further down the README are the local/IDE route. The browser route lives entirely in the PPTX.

---

🗺️ The Whole Process

YOUR 6 STEPS
│
├── 1. Clone the repo           →  get a copy on your laptop
├── 2. Create your branch       →  NEVER work on main
├── 3. Add your line            →  one line, at the bottom
├── 4. Commit + push            →  send it to GitHub
├── 5. Open a Pull Request      →  base branch = main
└── 6. Pull main when done      →  all 4 names appear

flowchart LR
    A[Clone] --> B[Branch]
    B --> C[Edit file]
    C --> D[Commit]
    D --> E[Push]
    E --> F[Pull Request]
    F --> G[Teammate merges]
    G --> H[Pull main]
    style G fill:#238636,color:#fff
    style H fill:#238636,color:#fff

Loading

---

🏷️ Your Branch Name

Member	Branch name	Your line
Joseph Clay	joseph-clay	Hello from Joseph Clay
Shareefah Adeola-Ogunwolu	shareefah-ogunwolu	Hello from Shareefah Adeola-Ogunwolu
Alexander Debusk	alexander-debusk	Hello from Alexander Debusk
Yilin Leng	yilin-leng	Hello from Yilin Leng

---

💻 The Commands — Copy, Paste, Go

1️⃣ Clone the repo

git clone https://github.com/ClayClimate-AI/ITAI_ML_FirstRepo_Turing_Collective.git
cd ITAI_ML_FirstRepo_Turing_Collective

2️⃣ Create your branch

git checkout main
git pull origin main
git checkout -b yourname

git branch          # ✅ the * must be on YOUR branch, not main

3️⃣ Add your line to hello_ml.txt

Open it in VS Code and append one line at the bottom. Don't touch anyone else's line.

This is my first GitHub file for the Classic Machine Learning course.
Hello from Joseph Clay
Hello from [Your Full Name]     ← yours goes here

git diff            # ✅ should show ONE green + line, ZERO red - lines

4️⃣ Commit and push

git add hello_ml.txt
git commit -m "Add greeting from [Your Full Name]"
git push -u origin yourname

5️⃣ Open the Pull Request

1. Refresh the repo on GitHub
2. Click the yellow "Compare & pull request" banner
3. Confirm it says base: main ← compare: yourname
4. Title: Add greeting from [Your Full Name]
5. Click Create pull request
6. Ask a teammate to merge it — you don't merge your own

6️⃣ Pull the final version

git checkout main
git pull origin main
cat hello_ml.txt    # ✅ all four names should be there

---

🔍 Did My Pull Request Go Through?

Repo page → click "Pull requests" tab
│
├── Is your PR in OPEN?      →  created, waiting on a teammate to merge
├── Is it in CLOSED?
│   ├── 🟣 Purple "Merged"   →  ✅ DONE
│   └── 🔴 Red "Closed"      →  ❌ rejected — open a new PR
└── Not in either tab?       →  ❌ it was never created — redo Step 5

Quick links

• All pull requests
• All branches

---

✅ Your Checklist

• Cloned the repo
• Created my own branch (not main)
• Added exactly one line: Hello from [My Full Name]
• Deleted nobody else's line
• Committed and pushed my branch
• Opened a PR with base branch main
• A teammate reviewed and merged it (purple Merged badge)
• Ran git pull origin main — all four names in the file

Done = all 8 boxes checked.

---

📊 Team Status

Member	Branch	PR	Merged
Joseph Clay	✅	✅ #1	✅
Shareefah Adeola-Ogunwolu	✅	✅ #4	✅
Alexander Debusk	✅	✅ #3	✅
Yilin Leng	✅	✅ #2	✅

---

🚨 If Something Breaks

Error	Fix
Permission denied ... 403 on push	You need collaborator access — ask Joseph for an invite
Don't want to wait for a collaborator invite	Fork the repo instead — click Fork at the top right, work in your own copy, then open a PR back to this repo. Yilin used this route and it worked cleanly.
Git rejects your password	Run gh auth login (GitHub CLI) or sign in through VS Code
Branch not showing on GitHub	You committed but forgot to push → git push -u origin yourname
Committed on main by mistake	git checkout -b yourname then push — the commit comes with you
"This branch has conflicts"	Normal. Fix below ⬇️

Merge conflict fix — happens because we're all adding to the same last line:

git fetch origin
git merge origin/main

Open hello_ml.txt, keep BOTH names, delete the <<<<<<<, =======, >>>>>>> lines. Then:

git add hello_ml.txt
git commit -m "Resolve conflict: keep all greetings"
git push

❗ Never fix a conflict by deleting a teammate's line — that costs them their grade.

---

ITAI-1371 · Houston Community College Maintained by @ClayClimate-AI