diff --git a/README.md b/README.md index bed199d..0b252d8 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,42 @@ -## Exercise: Branch Out with GitHub Branches! 🌲 +## Exercise 1: Setting Up and Collaborating on GitHub 🌐 -**Objective**: Delve into one of Git's most powerful features: branching. By the end of this exercise, you'll have created, navigated, and understood the essence of branches in GitHub, setting a solid foundation for parallel development and experimentation without disrupting the main codebase. +**Objective**: Get a hands-on introduction to various GitHub features such as profile customization, forking, and pull requests. By the end of this exercise, you'll have a personalized GitHub profile, a forked repository, and experience collaborating on a project. ### Instructions: -1. **Understanding Branches**: Before making one, it's crucial to grasp the concept. A branch in Git is essentially a unique set of code changes with a unique name. It represents an independent line of development, allowing you to work on multiple features or fixes simultaneously without them affecting each other. +1. **Craft Your GitHub Identity**: + - Visit the [GitHub guide](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme). + - Create a `README.md` to personalize your profile. + +2. **Make Your Copy**: + - Navigate to the [forking instructions](https://docs.github.com/en/get-started/quickstart/fork-a-repo#forking-a-repository). + - Fork our [project repository](https://github.com/grundkurs-git/.github), creating your personal copy + - Use "grundkurs-git" as name + +3. **Roster Update**: + - Within your forked repository, find the **Participants HS23** list. + - Edit the file to include a link to your GitHub profile. + +
+ +Tips + +The list is located under `profile/README.md` + +
+ + +4. **Become a Contributor**: + - Once your profile link is added in your local copy, initiate a Pull Request to propose your updates to the [course project](https://github.com/grundkurs-git/.github). + - To initiate a pull request, locate the "Contribute" dropdown (often found towards the upper right). + - Click on "Contribute" and select "Open pull request". + - Ensure you're proposing changes from your branch/fork to the main branch of the [course project](https://github.com/grundkurs-git/.github). + - Submit your pull request with a succinct, descriptive message detailing your proposed alterations. + +### Reflection: + +1. Describe the significance of forking in collaborative projects. +2. What is the purpose of a Pull Request and how does it facilitate collaboration? + +Give yourself a pat on the back! 🌟 These foundational steps are your gateway to a world of collaborative coding and open-source contributions. Keep up the momentum! -2. **Switch Between Branches**: - - Find the drop-down menu labeled "main". - - Click on it and select "exercise 1" - - Notice how the codebase changes as you switch between them. diff --git a/profile/README.md b/profile/README.md index 8a7b395..f1cb4b8 100644 --- a/profile/README.md +++ b/profile/README.md @@ -8,7 +8,7 @@ Noe ### Participants HS23 - https://github.com/noeleont - +- https://github.com/ruitongl