iamc / sayhi

Playing with GitHub Pull Requests (PR)

sayhi

Playing with GitHub forks and Pull Requests (PR). Homework for 2023-01-10-cfm Software Carpentry Git lesson.

You can think of forking as a kind of clone, but between GitHub repos, and with GitHub being aware of a repo being forked, and where a fork "comes" from.

Follow the instructions below.

Sort instructions

In GitHub 1) fork this repo, 2) clone the forked repo from your GitHub account to your computer. In your computer 3) add a new file named as by your GitHub username, <YOUR_USERNAME>.txt, so that you don't step on each other's foot, with a "hi!" message inside. git add and commit this new file ito your local repository. Now 4) push changes to your GitHub forked repo and, finally, from within the GitHub web interface of your forked repo, 5) submit a pull request (Contribute -> Create pull request) to this repo (iamc/sayhi).

I'll 6) review your pull request and accept it.

Step-by-step instructions

0. Sign in into your GitHub account and go to this repository https://github.com/iamc/sayhi .
1. Click the upper rigth Fork button. As you do it you will be taken to your own account, to your sayhi forked repositry. Under the repository name (<YOUR_USERNAME>/sayhi), you will see the text: "Forked from iamc/sayhi".
2. Go to your computer and clone YOUR fork (<YOUR_USERNAME>/sayhi) (green <> Code button, clone, select SSH and copy-paste to your terminal): git clone [e-mail]:<YOUR_USERNAME>/saihi.git.
3. Create a new file <YOUR_USERNAME>.txt, put some text in it, and git add and commit the file in your local repository.
4. Push your local repo to GitHub remote repo with git push origin main.
5. Now in GitHub web interface you will see something like "This branch is XX commits ahead of iamc:main.", and in the same "bar" the text Contribute. Click there and click the Open pull request button in the emerging window. Write the pull request message there and click the green button Create pull request.
6. Now I (iamc) will get a message about your PR submission. As your username is unique in GitHub, and you so named the new file, there will be no conflicts with my repository; I'll review your PR and accept it. This will be reflected in your forked repo and this will have been your first pull request ever and your first step into the open source contribution Hall of Fame 😃

Enjoy!