🎯 If you are a beginner, and looking for your first contribution, we are here to help. Just append a program and its short description in our
https://github.com/Awanit512/HactoberFest-2K21-5-1-2-
and that counts as your first PR. 🎯
🙅🏼♂️Hacktoberfest is open to everyone in our global community. Whether you’re new to development, a student, long-time contributor, event host, or company of any size, you can help drive growth of open source and make positive contributions to an ever-growing community. All backgrounds and skills levels are encouraged to complete the challenge.🙅🏼♂️
💻 Make all Pull requests to the "develop" branch only. Let's maintain a stable main(master) branch that is deployed. Changes would be merged later on to the main(master) branch.
Link to register: https://hacktoberfest.digitalocean.com/
Download Git and after installing go to git bash or cmd window and setup your identity using
git config --global user.name "Github wala username"
git config --global user.email example@gmail.com
Download and install VS code editor for getting good feel while writing codes
GitHub repository URLs will reference both the username associated with the owner of the repository, as well as the repository name.
When you’re on the main page of the repository, you’ll see a button to "Star" and “Fork” the repository on your upper right-hand side of the page, underneath your user icon.
To make your own local copy of the repository you would like to contribute to, let’s first open up a terminal window(Command prompt).
This URL will be similar to the URL above, except now it will end with .git.
In the example above, the URL will look like this:
https://github.com/your-username/CodeToGrow
You can alternatively copy the URL by using the green “Clone or download” button from your repository page that you just forked from the original repository page. Once you click the button, you’ll be able to copy the URL by clicking the binder button next to the URL.
Once we have the URL, we’re ready to clone the repository. To do this, we’ll combine the git clone command with the repository URL from the command line in a terminal window:
git clone https://github.com/your-username/CodeToGrow.git
To create your own branch, from your terminal window, change your directory so that you are working in the directory of the repository. Be sure to use the actual name of the repository (i.e. CodeToGrow) to change into that directory.
Now, we’ll create our new branch with the git branch command. Make sure you name it descriptively so that others working on the project understand what you are working on.
Now that our new branch is created, we can switch to make sure that we are working on that branch by using the git checkout command:
At this point, you can now modify existing files or add new files to the project on your own branch.
Open the folder in VS code manually or use code .
in command prompt it will directly open the all the files in editor.
Add solution file(with .java/.cpp/.py extention) to the already available question in any directory OR add a folder with question name as folder, add Question.md
orQuestion.txt
file which contains question in text along with sample input and output also add solution in any of the language mentioned. The file flow after this should look like:
- Recursion Backtracking
- N-Queen(this will be folder of question)
Question.md
NQueen.java
NQueen.cpp
NQueen.py
- another question folder...
- N-Queen(this will be folder of question)
Once you have modified existing files or added new files to the project, you can add them to your local repository. You can do with the git add command. Let’s add the -A flag to add all changes that we have made:
The commit message is an important aspect of your code contribution; it helps the other contributors to fully understand the change you have made, why you made it, and how significant it is. Additionally, commit messages provide a historical record of the changes for the project at large, helping future contributors along the way. Thus, you must ensure that you write a meaningful commit message.
At this point you can use the git push command to push the changes to the current branch of your forked repository:
⚡⚡NOTE: After this you can directly go to github and create pull request to Base YABHAKRITI repository i.e step 8. Else for getting more clear understanding of working on github follow steps 5,6,7 that will help in syncing the project to remote Repo, this is very important when you are working on group project.
While working on a project alongside other contributors, it is important for you to keep your local repository up-to-date with the project as you don’t want to make a pull request for code that will cause conflicts. To keep your local copy of the code base updated, you’ll need to sync changes.
Next, you’ll have to specify a new remote upstream repository for us to sync with the fork. This will be the original repository that you forked from. You’ll have to do this with the git remote add command.
git remote add upstream git@github.com:Awanit512/HactoberFest-2K21-5-1-2-.git