Skip to content

🚩 This is intended to be used to introduce people to Git through GitHub

License

Notifications You must be signed in to change notification settings

abozadev/workshop-guestbook

 
 

Repository files navigation

Workshop Guestbook 📓

Hey welcome to this workshops guestbook! By signing this guestbook we will explore many of the core concepts of GitHub. By the end of this workshop you will have forked a repo, created a commit, made a pull request and signed your name on the guestbook.

Signing the guestbook

Using GitHub.com

Forks

GitHub let's you adapt any piblic repository using forks. Forks copy the entire repository to your profile so that you have ownership and controll. This let's you add features to a project without needing to request direct access to a repository.

Let's fork this repository to get started:

fork

Making a change

The repository will now exist as a seperate repository under your GitHub profile. From your fork go to the /_guestbook folder and click on Create new file. Name this file yourname.yaml. Then paste the bellow template into your file and replace it with your details. You can delete any fields you dont want to fill except name and image

---
name: Pandelis
image: https://avatar.tobi.sh/tobiaslins.svg?text=PZ
emoji: 🐼
message: Hey! I hope you're enjoying the workshop.
twitter: PandelisZ
github: PandelisZ
---

fork

If you don't wish to use a photo of yourself leve the placeholder image and add your initials as ?text=PZ for example.

You can find your favorite emoji at emojipedia.org and paste it into the emoji field

Commiting

At the bottom of the new file page you'll be able to submit this change as a commit. Scroll to the bottom of the page and enter the commit details. Commit messages should be short and descriptive so that others can tell what you're changing or adding.

commit

Submitting a pull requst

Now that you have made your desired changes to the repo you can submit them upstream (the original repository). The way we do this within the GitHub flow is by creating a pull request on the upstream repository. In this case the upstream repository is the original repository you forked. This is shown on your repo as forked from: at the top of the repository page.

To submit a pull request navigate to the original upstream repository and go to the Pull requests tab and click New pull request. If GitHub does not automatically detect your fork you can click on compare across forks. Then create the pull reqeust

pull request

Congrats 🎉

You've sucessfully creted a pull request! You're changes will now have to be reviewed. If you're filled out your details correctly your pull request will be approved and you will show up on the guestbook.

About

🚩 This is intended to be used to introduce people to Git through GitHub

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • CSS 79.0%
  • HTML 11.3%
  • Ruby 9.7%