ML Git Challenge: Collaboration & Git Fundamentals

Estimated time: 60–90 minutes

Overview

Welcome to the ML Git Challenge! This shared project will help you practice essential Git commands and collaborative workflows like branching, committing, pushing, and pulling.

You'll work in groups on separate directories within this repository. Each group has specific tasks to complete by creating feature branches, pushing code, and coordinating merges.

---

Groups and Assignments

Group	Members (GitHub usernames)	Assigned Tasks
1	Arber (arberzylyftariholberton), Megi (Megi96), Erdi (erdi6sh), Alvi (astheone)	Complete Python data processing tasks 1-4
2	Sindi (sindi16), Sara (saralozi), Kloe (kloekam)	Complete Python data processing tasks 5-7
3	Krisalda (krisaldamihali), Peter (pjepri), Frenki (frenk1j)	Provide example code snippets demonstrating key NumPy vector/matrix operations
4	Donald (donaldgjegji1-maker), Sara (Sara2-3), Egi (egigj-dev)	Create a brief, well-researched Markdown document on the importance of vectors in Machine Learning

---

Project Structure & Workflow

Each group will work inside their dedicated folder:

• group-1/
• group-2/
• group-3/
• group-4/

Workflow:

1. Clone the repo locally.
2. Make sure to always pull the latest changes before you modify, commit and push your own files.
3. Create a feature branch from main following the naming convention group-x-feature.
4. Complete your assigned tasks inside your group folder.
5. Stage, commit, and push your changes to your branch.
6. When ready, create a pull request to merge your branch into main.
   • When your group finishes working on your branch, push your changes and create a Pull Request (PR) on GitHub to merge into main. PRs let others review your work before it becomes final.
   • You can find more details here
7. Collaborate with your team and reviewers on any suggested improvements.

---

Requirements

• Python scripts (.py files) for groups 1, 2, and 3 tasks.
• Markdown document (.md file) for group 4’s vector importance write-up.
• Use meaningful, clear commit messages.
• Include comments in your code to explain your logic.
• Test your code/functionality before pushing.
• Coordinate within your group to avoid overlapping work.

---

Submission Checklist

• Each member pushes at least one commit.
• Group branch pushed and pull request created.
• Tasks completed as per instructions.
• Group folder includes all relevant files (code snippets, documentation).

---

Helpful Git Commands

Command	Explanation
git clone [repo-url]	Download the repository
git checkout -b branchname	Create & switch to a new branch
git add .	Stage all changes
git commit -m "message"	Commit staged changes
git push origin branchname	Upload your branch to GitHub
git pull origin main	Update local repo with latest main

---

Instructor Support

Reach out on Slack if you face any issues with Git commands, collaboration, or task understanding.

---

Good luck and collaborate effectively!