Hello VSCode and Hello Github Classroom!

Part 1: GitHub Classroom Set-up

Step 1: Accept the Assignment (One Person Per Group)

Go here: https://classroom.github.com/a/F9QCHrtR
Sign into GitHub if you aren't signed in, then select your name from the list
Create or join a team:
- If you're first in your group: Click "Create a new team" and name it (e.g., "team-alice-bob")
- If teammate already started: Find and click on your team name
Click "Accept this assignment"
Click on repository URL to open it - it will look something like this:
```
https://github.com/cdsds210-fall25-b1/activity6-team-alice-bob
```

Step 2: Clone the Repository (Everyone)

Open a terminal and navigate to where you keep your projects (optional, but recommended for organization).

cd path/to/your/projects/

In the GitHub webpage for your group, click the green "code" button, selcet the autheticaion method you set up (HTTPS, SSH, or CLI (gh)), and copy the link.

Then clone the repo in your terminal. Your clone command will look like one of these:

git clone https://github.com/cdsds210-fall25-b1/your-team-repo-name.git # HTTPS
git clone git@github.com:cdsds210-fall25-b1/your-team-repo-name.git # SSH
gh repo clone cdsds210-fall25-b1/your-team-repo-name # CLI

Troubleshooting:

If HTTPS asks for password: Use your GitHub username and a personal access token (not your GitHub password)
If SSH fails: Try following the instructions for setting up HTTPS (pinned on Piazza)

Step 3: Open in VSCode (Everyone)

cd your-team-repo-name
code .

You may see recommendations for a few extensions - go ahead and install them if you want!

Step 4: VSCode Exploration

From within your project, open src/main.rs in the navigation sidebar.

Explore These Features:

Hover over variables - What type information do you see?
Type println! and wait - Notice the autocomplete suggestions
Introduce a typo (like printl!) - See the red squiggle error
Right-click on rand - Try "Go to Definition"
Open integrated terminal (Ctrl+` or View -> Terminal)
Run cargo run from the VSCode terminal

Take a look at src/main.rs the repo as a group and identify two errors using VSCode hints and/or cargo check (you may need to fix one bug first in order to find the other). Then divide up these tasks among your team:

Fixing the bugs (could be one person or split among two people)
Adding some comments into src/main.rs to explain how the code works
Editing the README.md file to include a short summary of how you found the bugs, anything that was confusing or rewarding about this activity, or any other reflections

Step 2: Make individual branches

Make a branch that includes your name and what you're working on, eg. ryan-semicolon-bug-fix or kia-adding-comments

git checkout -b your-branch-name

Step 3: Fix your bug and/or add comments

Talk to each other if you need help!

Step 4: Commit and push

git add . # or add specific files
git commit -m "fix missing semicolon" # your own descriptive comment here 
git push -u origin ryan-semicolon-bug-fix # your own branch name here

Step 5: Create a Pull Request

Go to your team's GitHub repository in your browser
Click the yellow "Compare & pull request" button (or go to "Pull requests" → "New pull request")
Make sure the base is main and compare is your branch
Write a title like "Fix semicolon bug"
Click "Create pull request"

Step 6: Review PRs and Merge

Look at someone else's pull request (not your own!)
Click "Files changed" to see their changes
Leave feedback or request other changes if you want
When you're ready, go to "Review changes" -> "Approve" -> "Submit review"
Click "Merge pull request" -> "Confirm merge"

If you encounter "merge conflicts" try following these instructions.

Step 7: Is it working?

Run git checkout main and git pull when you're all done, and cargo run to see if your final code is working!

There's no "submit" button / step in GitHub Classroom - when you're done and your main branch is how you want it, you're done!

Lauren's DS210 Materials