:star_struck: Hacktoberfest_2021 :star_struck:

This repository aims to help code beginners with their first successful pull request and open source contribution. :partying_face:

:star: Feel free to use this project to make your first contribution to an open-source project on GitHub. Practice making your first pull request to a public repository before doing the real thing!

:star: Make sure to grab some cool swags during Hacktoberfest by getting involved in the open-source community.

This repository is open to all members of the GitHub community. Any member can contribute to this project! :grin:

:point_right: Repo link: https://github.com/chandrikadeb7/Hacktoberfest_2021

What is Hacktoberfest? :thinking:

Hacktoberfest — brought to you by DigitalOcean in partnership with GitHub and Intel — is a month-long celebration of open source software. Maintainers are invited to guide would-be contributors towards resolving issues that will help move the project forward, and contributors get the opportunity to give back to both projects they like, and ones they've just discovered. No contribution is too small — bug fixes and documentation updates are valid ways of participating. Celebrated every month of October based on the German festivity Oktoberfest.

Hacktoberfest is open to everyone in the global community. Whether you’re a developer, student learning to code, event host, or company of any size, you can help drive growth of open source and make positive contributions to an ever-growing community.

Visit the official website of Hacktoberfest.

Rules :fire:

To qualify for the official limited edition Hacktoberfest shirt, you must register here and make four Pull Requests (PRs) between October 1-31, 2021 (in any time zone). PRs can be made to any public repo on GitHub, not only the ones with issues labeled Hacktoberfest. This year, the first 50,000 participants who complete the challenge will earn a T-shirt or have a tree planted in their name.

Choose from these tasks :rainbow:

Here are 3 quick and easy ways to contribute to this project:

Task 1: Add your program question and solution :innocent:

Add any programming question and its solution in a separate folder and make your way to Open Source.

:star: The file structure will be as follows:

<name of program>/
├── question.md
├── <solution> (Solution file in any language including C/Java/Python etc.)

:eyes: Upload your contribution here in this folder Task 1

Task 2: Submit your own portfolio page :eyes:

Host your very own portfolio page in minutes and share with us to get nearer to swags

You can take help from one of my blogs :point_right: Visit Blog

:star: The file structure will be as follows:

<your name>/
├── <all files/folders> (In any language including C/Java/Python etc.)

:eyes: Upload your contribution here in this folder Task 2

Task 3: Show your algorithm skills :rocket:

Help us in making a one-stop place to find necessary codes and articles, which can vary from Hello World to Dynamic Programming in any language of your choice.
:star: The file structure will be as follows:

<algorithm name>/
├── <implementation file> (With commented sample input/output. In any language including C/Java/Python etc.)

:eyes: Upload your contribution here in this folder Task 3

Choose one or all 3, make a pull request for your work and wait for it to be merged! :heart:

Steps to follow :scroll:

0. Star the repo :star2:

Star the repo by pressing the topmost-right button to start your wonderful journey.

1. Fork it :fork_and_knife:

You can get your own fork/copy of HacktoberFest_2021 by using the Fork button or clicking this at top-right of your screen.

2. Clone it :busts_in_silhouette:

NOTE: commands are to be executed on Linux, Mac, and Windows(using Powershell)

You need to clone (download) it to local machine using

$ git clone https://github.com/Your_Username/Hacktoberfest_2021.git

This makes a local copy of the repository in your machine.

Once you have cloned the Hacktoberfest_2021 repository in Github, move to that folder first using change directory command on Linux, Mac, and Windows(PowerShell to be used).

# This will change directory to a folder Hacktoberfest_2021
$ cd Hacktoberfest_2021

Move to this folder for all other commands.

3. Set it up :arrow_up:

Run the following commands to see that your local copy has a reference to your forked remote repository in Github :octocat:

$ git remote -v
origin  https://github.com/Your_Username/Hacktoberfest_2021.git (fetch)
origin  https://github.com/Your_Username/Hacktoberfest_2021.git (push)

Now, let's add a reference to the original Hacktoberfest_2021 repository using

$ git remote add upstream https://github.com/chandrikadeb7/Hacktoberfest_2021.git

This adds a new remote named upstream.

See the changes using

$ git remote -v
origin    https://github.com/Your_Username/Hacktoberfest_2021.git (fetch)
origin    https://github.com/Your_Username/Hacktoberfest_2021.git (push)
upstream  https://github.com/Remote_Username/Hacktoberfest_2021.git (fetch)
upstream  https://github.com/Remote_Username/Hacktoberfest_2021.git (push)

In your case, you will see

$ git remote -V
origin    https://github.com/Your_Username/Hacktoberfest_2021.git (fetch)
origin    https://github.com/Your_Username/Hacktoberfest_2021.git (push)
upstream  https://github.com/chandrikadeb7/Hacktoberfest_2021.git (fetch)
upstream  https://github.com/chandrikadeb7/Hacktoberfest_2021.git (push)

4. Sync it :recycle:

Always keep your local copy of the repository updated with the original repository. Before making any changes and/or in an appropriate interval, run the following commands carefully to update your local repository.

# Fetch all remote repositories and delete any deleted remote branches
$ git fetch --all --prune

# Switch to `main` branch
$ git checkout main

# Reset local `main` branch to match the `upstream` repository's `main` branch
$ git reset --hard upstream/main

# Push changes to your forked `Hacktoberfest_2021` repo
$ git push origin main

5. Ready, steady, go... :turtle: :rabbit2:

Once you have completed these steps, you are ready to start contributing by checking our Good First Issue Issues and creating pull requests.

6. Create a new branch:bangbang:

Whenever you are going to contribute. Please create a separate branch using command and keep your main branch clean (i.e. synced with remote branch).

# It will create a new branch with name Branch_Name and switch to branch Folder_Name
$ git checkout -b BranchName

Create a separate branch for contribution and try to use the same name of the branch as of folder.

To switch to the desired branch

# To switch from one folder to other
$ git checkout BranchName

To add the changes to the branch. Use

# To add all files to branch Folder_Name
$ git add .

Type in a message relevant for the code reviewer using

# This message get associated with all files you have changed
$ git commit -m 'relevant message'

Now, Push your awesome work to your remote repository using

# To push your work to your remote repository
$ git push -u origin BranchName

Finally, go to your repository in the browser and click on compare and pull requests. Then add a title and description to your pull request that explains your precious effort.

Awesome contributors :star_struck:

Made with contributors-img.

Help contributing guides :crown:

We love to have articles and codes in different languages and the betterment of existing ones.

Please discuss it with us first by creating a new issue.

:tada: :confetti*ball: :smiley: *Happy contributing! :smiley: :confetti_ball: :tada: