Skip to content

Latest commit

 

History

History
101 lines (54 loc) · 4.96 KB

File metadata and controls

101 lines (54 loc) · 4.96 KB

Making your first contribution using GitHub Desktop

GitHub Desktop

1. Complete steps 1-3 in README.MD

Be sure you have completed steps 1 - 3 in the README.MD file.

2. Fork this repository

Fork this repository by clicking on the fork button on the top right of the main page of the repository here. This will create a copy of this repository in your personal GitHub account.

3. Clone the repository to your machine

Go to your personal GitHub account and click on the forked copy of the repository that should now be listed. Click on the green Code button.

clone this repository

To clone the repo, click on Open with GitHub Desktop button.

clone this repository

At this point, if you do not have GitHub Desktop installed, install it. If it is already installed, a pop up window will ask you if you want to use GitHub Desktop to open the link, select "open" or "open link".

The contents will be downloaded to your computer.

clone this repository

Now you have copied the contents of the Hacktoberfest_2020 repository in GitHub to your personal computer.

4. Create a branch

Now create a branch by clicking on the Current Branch icon at the top and then click on New Branch: make a branch

Click on Create New Branch

name your branch

Name your branch . For example, "add-jane-smith" and click Create Branch to finish. name your branch

5. Make necessary changes and Commit those changes

Now open first_duty_station.md file in a text editor, and follow the instructions on what to do.

Be sure to save the file!

In GitHub Desktop, the Changes tab should update and the right hand side will show the file.

check status

You can see that there are changes to first_duty_station.md and they have been added to the Github Desktop. The green highlighted line and the plus to the left that shows that it's an addition to the file. If the line was red there would be a minus sign, that would mean the item is being removed from the file.

Now, it's time to Commit the changes to your GitHub repository. Write a message in the bottom left box explaining what you're committing. In this case, "add jane smith to first_duty_station.md". Then click the button below to Commit to add-jane-smith (that will vary based on what you named your branch).

check status

At the bottom left, you can see that the commit has been created.

commit your changes

6. Push changes to GitHub

Next you want to push those changes to your personal GitHub account, so click Publish branch. If you get a message to log in to your GitHub account, do that now.

commit your changes

7. Submit your changes for review

The final step is to create your pull request. You can start that here by clicking the Create Pull Request button.

create a pull request

Your personal GitHub account will open directly to the Pull Request option on your repo. Click the green Create Pull Request button.

create a pull request

Make sure it has a subject typed in and add any comments if necessary. Click Create Pull Request one more time.

submit pull request

That's it! Soon we'll be merging all your changes into the master branch of this project. You will get a email notification once the changes have been merged.

Where to go from here?

Congrats! You just completed the standard fork -> clone -> edit -> PR workflow that you'll encounter often as a contributor!

Celebrate your contribution and share it with your friends and followers by going to:

You can join our slack team in case you need any help or have any questions. [Join slack team]

Now let's get you started with contributing to other projects. We've compiled a list of projects with easy issues you can get started on. Check out the list of projects in web app.