Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added .github/images/add-profile-file.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .github/images/branch-selection-comparison.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .github/images/branch-selection-dropdown.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .github/images/code-tab-highlight.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .github/images/commit-message-dialog.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .github/images/compare-pull-request-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .github/images/create-branch-prompt.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .github/images/create-new-file-option.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .github/images/create-pull-request-form.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .github/images/delete-branch-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .github/images/example-profile-readme.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added .github/images/merge-pull-request-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
8 changes: 4 additions & 4 deletions .github/steps/1-create-a-branch.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,27 +24,27 @@ For more information, see "[About branches](https://docs.github.com/en/pull-requ
is essentially an "About me" section on your GitHub profile where you can share information about yourself with the community on GitHub.com.
GitHub shows your profile README at the top of your profile page. For more information, see "[Managing your profile README](https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-github-profile/customizing-your-profile/managing-your-profile-readme)".

![screenshot showing an example profile readme](https://github.com/user-attachments/assets/fdc3a590-0bab-4758-9aec-6fd93c1d81a6)
![screenshot showing an example profile readme](../images/example-profile-readme.png)

### :keyboard: Activity: Your first branch

1. Open a new browser tab and navigate to your newly made repository (your copy of this exercise). Then, work on the steps in your second tab while you read the instructions in this tab.

2. Navigate to the **< > Code** tab in the header menu of your repository.

![screenshot highlighting the code tab](https://github.com/user-attachments/assets/9a310b11-d80b-4b0f-bddc-aa41a8c01269)
![screenshot highlighting the code tab](../images/code-tab-highlight.png)

3. Click on the **main** branch drop-down.

<img width="300" alt="screenshot highlighting the branch selection" src="https://github.com/user-attachments/assets/9256e36d-4c17-4629-95df-863d42a3c182">
<img width="300" alt="screenshot highlighting the branch selection" src="../images/branch-selection-dropdown.png">

4. In the text box **Find or create a branch...**, enter `my-first-branch`.

> **Note:** This is checked to continue with the next step. :wink:

5. Click the text **Create branch: `my-first-branch` from main** to create your branch.

<img width="300" alt="screenshot highlighting the create branch prompt" src="https://github.com/user-attachments/assets/df0f369f-0669-4f9e-b9f3-b82515ec2a6c">
<img width="300" alt="screenshot highlighting the create branch prompt" src="../images/create-branch-prompt.png">

- The branch will automatically switch to the one you just created.
- The **main** branch drop-down menu will display your new branch name.
Expand Down
6 changes: 3 additions & 3 deletions .github/steps/2-commit-a-file.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ The following steps will guide you through the process of committing a change on

2. Select the **Add file** drop-down and click **Create new file**.

<img width="300" alt="screenshot of the create new file option" src="https://github.com/user-attachments/assets/a86c088e-b377-43f7-96e6-e68f7aef1cd3">
<img width="300" alt="screenshot of the create new file option" src="../images/create-new-file-option.png">

3. In the **Name your file...** field, enter `PROFILE.md`.

Expand All @@ -27,15 +27,15 @@ The following steps will guide you through the process of committing a change on
Welcome to my GitHub profile!
```

![screenshot for adding the profile.md file](https://github.com/user-attachments/assets/487c0ba4-88d8-4634-8715-a170413369d0)
![screenshot for adding the profile.md file](../images/add-profile-file.png)

5. Click **Commit changes...** in the upper right corner above the contents box. A dialog will appear.

6. GitHub offers a simple default message, but let's change it slightly for practice. Enter `Add PROFILE.md` in the **Commit message** field.

- A **commit message** and optional **extended description** help provide clarity for your changes. This is particularly useful when your commit involves several files.

<img width="400" alt="screenshot of adding a new file with a commit message" src="https://github.com/user-attachments/assets/5472be49-6a6c-4b9c-ba2b-151ded73921f">
<img width="400" alt="screenshot of adding a new file with a commit message" src="../images/commit-message-dialog.png">

6. In this lesson, we'll ignore the other fields for now and click **Commit changes**.

Expand Down
6 changes: 3 additions & 3 deletions .github/steps/3-open-a-pull-request.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ Now that you have made a change to the project and created a commit, it’s time

You may have noticed after your commit that a message displayed indicating your recent push to your branch and providing a button that says **Compare & pull request**.

![screenshot of message and button](https://github.com/user-attachments/assets/a9f29bd2-0461-4bf9-9935-67730761bcd3)
![screenshot of message and button](../images/compare-pull-request-button.png)

To create a pull request automatically, click **Compare & pull request** button, and then skip to step 5 below. Alternately, you practice creating it manually using the first 4 steps.

Expand All @@ -21,15 +21,15 @@ To create a pull request automatically, click **Compare & pull request** button,
- **base:** `main`
- **compare:** `my-first-branch`

![screenshot showing both branch selections](https://github.com/user-attachments/assets/8f01524c-c973-4f4f-a75c-0717fe09b664)
![screenshot showing both branch selections](../images/branch-selection-comparison.png)

4. Click **Create pull request**.

5. Enter a title for your pull request. By default, the title will automatically be the name of your branch. For this exercise, let's edit the field to say `Add my first file`.

6. The next field helps you provide a **description** of the changes you made. Please enter a short description of what you’ve accomplished so far. As a reminder, you have: created a new branch, created a file, and made a commit.

![screenshot showing pull request](https://github.com/user-attachments/assets/c6e6af6b-d31e-4628-91ac-de6adb5b390c)
![screenshot showing pull request](../images/create-pull-request-form.png)

7. Click **Create pull request**.

Expand Down
4 changes: 2 additions & 2 deletions .github/steps/4-merge-your-pull-request.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ You successfully created a pull request. Now it's time to merge it!

**What is a merge?**: A _[merge](https://docs.github.com/en/get-started/quickstart/github-glossary#merge)_ adds the changes in your pull request and branch into the `main` branch. For more information about merges, see "[Merging a pull request](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/incorporating-changes-from-a-pull-request/merging-a-pull-request)."

![screenshot of green merge pull request button](https://github.com/user-attachments/assets/c691b064-0bd3-4448-bdcd-b1ad82fc9154)
![screenshot of green merge pull request button](../images/merge-pull-request-button.png)

### :keyboard: Activity: Merge the pull request

Expand All @@ -20,7 +20,7 @@ You successfully created a pull request. Now it's time to merge it!

3. Once your branch has been merged, you don't need it anymore. To delete this branch, click **Delete branch**.

![screenshot showing delete branch button](https://github.com/user-attachments/assets/29ddff73-865b-485c-abc6-3333bca71b76)
![screenshot showing delete branch button](../images/delete-branch-button.png)

4. Now that your work is merged, Mona will confirm and share some final review content. Nice work! 🎉

Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/0-start-exercise.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ jobs:
if: |
!github.event.repository.is_template
name: Start Exercise
uses: skills/exercise-toolkit/.github/workflows/start-exercise.yml@v0.7.0
uses: skills/exercise-toolkit/.github/workflows/start-exercise.yml@v0.8.0
with:
exercise-title: "Introduction to GitHub"
intro-message: "If you are new to GitHub, you might find your fellow developers use ___**issues**___ to organize their work and collaborate. We will do the same! That's another lesson, but today, we will introduce you to the basics."
Expand Down