Skip to content

๐Ÿš€๐ŸŒŸ A how-to guide to new users on open source contribution

Notifications You must be signed in to change notification settings

fosscit/basic-contributions

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

22 Commits
ย 
ย 
ย 
ย 

Repository files navigation

Basic Contributions - A guide to your first pull request

๐Ÿš€๐ŸŒŸ The intention of this project is to help you understand how to contribute to any project on GitHub and kick-start your open source contribution journey with Hacktoberfest. You will learn this by adding yourself onto this project's contributors list.

What is Hacktoberfest? ๐ŸŽƒ

Hacktoberfest is a month-long celebration of open source software run by DigitalOcean and DEV. You can win a free T-shirt ๐Ÿ‘• if you complete 4 PRs (Pull Requests). For more information and registration, check here.

What is GitHub? :octocat:

GitHub is a code hosting platform for version control and collaboration. It lets you and others work together on projects from anywhere. If it gets a bit overwhelming at first, we recommend you to check this.

IMPORTANT: MAKE SURE THAT YOU HAVE REGISTERED YOUR GITHUB PROFILE WITH HACKTOBERFEST (HERE) BEFORE PROCEEDING.

How to contribute?

Any type of contribution involves these basic steps:

  1. Forking
  2. Making Changes
  3. Committing changes (to fork)
  4. Pull Request (PR)
  5. Merging

Complex contributions may also involve: Cloning, and Branching. For the sake of simplicity, we won't be covering cloning and making local changes in this tutorial.

fork this repository

1. Fork

  • A fork is a copy of a repository. Forking a repository allows you to freely experiment with changes without affecting the original project.
  • To fork a project, click on the 'Fork' icon at the top right. A copy of this project will be created in your profile.

2. Making Changes

  • We will be editing the 'README.MD' file using GitHub to add your name onto the contributors list.
  • Select the README.MD file from project files list and select the EDIT icon.

README.MD

edit README.MD

  • Scroll down and add your name onto the end of contributors list in a new line using this format:
  * [your-username](https://www.github.com/your-username) <any-three-emojis>

Contributors

  • You are asked to add any 3 emojis that you may find interesting/really like/feel that describe you. Check this link to search and copy-paste emojis or this for GitHub-standard emojis.
  • .MD files use MARKDOWN markup language to format the text. For a cheat sheet, check this.

Commit changes

3. Committing Changes

  • Scroll down to the 'Commit changes' pane.
  • Type a title for your commit.
  • Click on the 'Commit changes' button.
  • The changes that you've made have been committed to your fork.

4. Pull Request (PR)

  • A 'Pull Request' is essentially a request to the author of the original repository to accept the changes you've made to your fork.
  • Start by heading to the original repository (basic-contributions).
  • To the right of the Branch menu, click 'New pull request'.

New pull request

  • On the Compare page, click 'compare across forks'.

Compare across forks

  • Confirm that the base fork (the one on the left) is the repository you'd like to merge changes into.
  • Select your fork on the right.

Open pull request

  • Type a title for your pull request like 'add(user):your-username'.
  • Select 'Create Pull Request'.

5. Merging

  • Merging your changes to the master fork is done by the owner.
  • So, wait it out, and congratulations on making your first PR!

What next?

Check issues marked with "good first issue" to find projects need your help!

Happy Contributing! ๐Ÿš€ ๐ŸŽ†


CONTRIBUTORS

About

๐Ÿš€๐ŸŒŸ A how-to guide to new users on open source contribution

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published