Skip to content

Remove fork details from git week 1 assignment and session plan - #331

Merged
saloumeh-67 merged 4 commits into
HackYourFuture-CPH:mainfrom
jason-vasilev:git-w1-assignment-update
Sep 21, 2026
Merged

saloumeh-67 merged 4 commits into
HackYourFuture-CPH:mainfrom
jason-vasilev:git-w1-assignment-update

Conversation

@jason-vasilev

Copy link
Copy Markdown
Contributor

Overview

We are simplifying the trainee Git workflow by moving away from the fork-based assignment setup.

Previously, trainees would fork the assignment template repository and open PRs from their fork back to the template repository. While this worked technically, it created unnecessary confusion around repository ownership, PR targets, and the fact that mentor-approved PRs would not be merged into the template repository.

New approach

Trainees should instead:

  1. Create a new, empty repository on their own GitHub account.
  2. Add the assignment files to their repository, using separate folders where appropriate.
  3. Create branches for their work.
  4. Open PRs against the main branch of their own repository.
  5. Have mentors review and approve those PRs as usual.

This keeps the entire workflow within the trainee's own repository and removes the distinction between the repository they work in and the repository they are expected to submit against.

Why we're changing this

The new setup is simpler and more intuitive, particularly for beginners. It avoids confusion around:

  • Which repository a PR should target.
  • Why a PR opened against the assignment template is not merged there.
  • What happens to approved PRs in the template repository.
  • The relationship between forks, upstream repositories, and the trainee's actual work.

It also makes the process easier for mentors to review and manage, since each trainee's work and PR history lives in a single repository.

In short, trainees work in their own repository, and PRs target their own main branch. This gives us a much simpler and more predictable workflow for both trainees and mentors.

Comment thread courses/foundation/git/week1/session-plan.md Outdated
Comment thread courses/foundation/git/week1/session-plan.md Outdated
2. Check out to a new branch called `html-and-css`
3. Add the session exercises from the previous week to the `html-css/week1` folder
3. Add the session exercises from the previous week to a folder called `week1` inside another folder called `html-css`
4. Create a PR (Pull Request) [to your own repository](https://github.com/HackYourFuture-CPH/hyf-assignment-template?tab=readme-ov-file#2-submission-process), from your `html-and-css` branch to merge changes into the `main` branch

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This link also leads to an explanation with forking (above the PR process description). Will you please update it too?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can remove it for now until we make a new instruction to replace it. Is that ok @diwanow and @jason-vasilev?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I thought about it, but it demonstrates how to make a PR without pointing to a forked repo. It's a bit confusing, but still shows good flow of how to make a PR.
@saloumeh-67 do we have other place where we show them how to make PRs and add them to the Assignment Google Sheet?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

With this setup, since everything lives in the trainee's own repository, there's no ongoing "sync" ? right? Then how do trainees receive new assignment files or updates from HYF's side later on?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I thought about it, but it demonstrates how to make a PR without pointing to a forked repo. It's a bit confusing, but still shows good flow of how to make a PR. @saloumeh-67 do we have other place where we show them how to make PRs and add them to the Assignment Google Sheet?

No But I can make a new one.

saloumeh-67 and others added 2 commits September 21, 2026 08:51
Co-authored-by: Dimitar Dimitrov <d_iwanow@outlook.com>
Co-authored-by: Dimitar Dimitrov <d_iwanow@outlook.com>

@diwanow diwanow left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you

Comment thread courses/foundation/git/week1/session-plan.md Outdated
Co-authored-by: Dimitar Dimitrov <d_iwanow@outlook.com>
2. Check out to a new branch called `html-and-css`
3. Add the session exercises from the previous week to the `html-css/week1` folder
3. Add the session exercises from the previous week to a folder called `week1` inside another folder called `html-css`
4. Create a PR (Pull Request) [to your own repository](https://github.com/HackYourFuture-CPH/hyf-assignment-template?tab=readme-ov-file#2-submission-process), from your `html-and-css` branch to merge changes into the `main` branch

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can remove it for now until we make a new instruction to replace it. Is that ok @diwanow and @jason-vasilev?


### Exercise 2

1. When you are on `main` branch, of the assignment repository create a branch named `git-week1/exercise-1/<your-name>` and move to it

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can remove it from this part, but then I need to remove this from all the exercises explanation, since it's been mention everywhere.

2. Check out to a new branch called `html-and-css`
3. Add the session exercises from the previous week to the `html-css/week1` folder
3. Add the session exercises from the previous week to a folder called `week1` inside another folder called `html-css`
4. Create a PR (Pull Request) [to your own repository](https://github.com/HackYourFuture-CPH/hyf-assignment-template?tab=readme-ov-file#2-submission-process), from your `html-and-css` branch to merge changes into the `main` branch

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

With this setup, since everything lives in the trainee's own repository, there's no ongoing "sync" ? right? Then how do trainees receive new assignment files or updates from HYF's side later on?

2. Check out to a new branch called `html-and-css`
3. Add the session exercises from the previous week to the `html-css/week1` folder
3. Add the session exercises from the previous week to a folder called `week1` inside another folder called `html-css`
4. Create a PR (Pull Request) [to your own repository](https://github.com/HackYourFuture-CPH/hyf-assignment-template?tab=readme-ov-file#2-submission-process), from your `html-and-css` branch to merge changes into the `main` branch

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I thought about it, but it demonstrates how to make a PR without pointing to a forked repo. It's a bit confusing, but still shows good flow of how to make a PR. @saloumeh-67 do we have other place where we show them how to make PRs and add them to the Assignment Google Sheet?

No But I can make a new one.

@saloumeh-67
saloumeh-67 merged commit db1272e into HackYourFuture-CPH:main Sep 21, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Backlog

Development

Successfully merging this pull request may close these issues.

3 participants