Debugit is a week long hackathon open to ideas in a very literal sense. You can make anything from the projects' list we'll share or ignite the inquisitive Bob the Builder inside you to make something exciting and completely new!
Submissions are to be made through GitHub Pull Requests. To know more about how to make a GitHub Pull Request you can refer the Fundamentals of Git playlist which contains everything that you would need.
Here is a detailed step by step walkthrough if you don't know how to make a Debugit submission.
-
Create a fork of this repository A fork is a copy of a repository. Forking a repository allows you to freely experiment with changes without affecting the original project.
- Click on the fork icon in the repository that you might find at the top right corner.
- It will ask you what would you like to name the forked repository. By default they are named the same as the parent directory. Lets keep the name as it is.
-
Clone the repository that you forked
- Find the link which you would need to clone and copy it.
- Go to the directory in which you want to clone your repository and open the terminal.
-
Now you can open the directory in vs code and play with the code and complete your project. Make sure to include a README.md file with your name, contact information, project description, how to run the code and a link to a demo video of your project (and other necessary information).
-
After completing the project, its time to push your code:
-
Open the vs code (or any other editor of your choice) terminal in the project folder.
-
Create a new branch in which you want to push your code using the following code.
git checkout -b <branch_name>
You can name your branch whatever you like.
-
Check which branch are you on using the
git branch
command.git branch
-
The branch name with a
*
on it is the current branch. If it is different from the branch that you created, then switch to your branch using thegit checkout
git checkout <branch_name>
-
You can check the status of the files using
git status
-
Add (Stage) all the files you want to upload using the
git add
command. To add individual files run the following command:git add <filename>
If you want to add all the files from your project directory you can run
git add .
It is recommended not to add the some directories like node_modules directory in your commit. You can prevent it by adding it in a
.gitignore
file (For more reference here). -
Commmit your code. You can commit all your staged code (to the local git repository) using the
git commit
command Run the following command:git commit -m "first commit"
You can replace
first commit
with anything. It is actually a message to let you keep a brief track of what changes has been done in that commit. -
Push your code. Push all of your commited code using the
git push
command. Run the following command:git push --set-upstream origin <branch_name>
-
-
Make the Pull Request and submit your code.
- After you push your code, it gets uploaded to your forked directory and creates a new branch that you created.
- If it notices any difference in the code of your forked repo and the parent repo. It automatically shows you an option to create a pull request.
- Write down a brief description of your project in the Pull Request description and give the PR a proper title and click on create pull request. Now GitHub might run some checks. If you pass all the checks, you are good to go.
-
Pat yourself on the back
All The Best ๐๐.