Every year in October, Digital Ocean and GitHub team up for an online event which celebrates open-source. Open-Source is one of the most growing areas in development these years. Also, it has made possible for beginners to grow and develop their skills as a programmer/developer. On a brighter side, you get some really cool freebies as well!
We’re excited to announce that Coding Blocks is taking part in Hacktoberfest for the first time! Coding Blocks invites you to contribute to our open source projects, which we’re calling #CodeLikeABoss. Enter to earn limited-edition CB swag!
The Coding Blocks Hacktoberfest challenge
We’ve got our own challenge for Hacktoberfest 2019 :
- You can open a PR for any of our open source projects. (PRs to fix typos in README will not be counted )
- If the PR you submit for any of the issues gets merged, you’ll win a limited edition Developer T-shirt along with a sticker pack!
- 1 - 4 pull requests: Limited-Edition T-shirt
- 5+ pull requests: Limited-Edition BAG
Join our Gitter channel for support - https://cb.lk/hacktoberfest/help
Claim here - https://cb.lk/hacktoberfest/swag
First and foremost, you need to register for Hacktoberfest before 31st Oct, for that you need a GitHub account, if you don’t have one, chill we’ve got you covered. Go to this link and create an account for free ! Celebrate Hacktoberfest with the global open source community.
Once your GitHub account is created, you can register for Hacktoberfest here! After registering for Hacktoberfest, you are officially a participant of Hacktoberfest! Now, you just need to start contributing to any projects out there on GitHub
First, learn about GitHub and pull requests if you don’t know about them.
Let's help you submit your first Pull Request.
For this exercise you'll be adding a new entry to the source code with your profile details. Excited? let's begin!
Go to the GitHub repository of this project and fork the project to your account. Click on the fork button on the top right corner of the repository page to do it. Once done, GitHub will take you to the forked copy in your account.
Clone the forked repository to your local machine. Click on the big green button saying "Clone or download" and copy the https url of your repository. Fire up the terminal (on Linux systems ctrl+alt+t and on Windows open the Git-bash ) navigate to your desired directory and type the following command. Replace the link with the clone URL of your repository and hit Enter.
git clone https://github.com/YOUR_USERNAME/make-a-pr.git
Let's start working on the changes required now! First Change directory into the cloned folder by typing the following command.
Before jumping in to the code, make sure you're working on a different branch and not in master. To create a new branch, from the terminal inside your current project directory type the following command.
git branch YOUR_USERNAME-profile
Replace the YOUR_USERNAME with your GitHub username or you can give any name to your branch which describes the purpose of the branch. Since here we're adding your profile, we'll simply give the name of the branch as above. eg: git branch sarthak-profile. Once you have created the new branch we'll change the current branch from master to your newly created branch. Execute the following command on your terminal.
git checkout YOUR_BRANCH_NAME
In your file manager/terminal navigate to the downloaded repo. Open the sub-directory src/profiles/. and create a new .md file with your username as the filename with .md extension.
It should look like YOUR_USER_NAME.md eg: sarthak-1998.md
Open this file in your favorite editor and fill the details as below in the front matter of the markdown file.
Add your profile page - YOUR_USER_NAME.md
Do not forget that the hyphens "---" are also part of the file. Once you finish adding the content, save the file.
Commit the changes with a suitable commit message. First we need to stage all the changes we made. Open the terminal inside the project directory and execute following commands.
git add -A
The above command stages all the changes, now lets commit it with a suitable message.
git commit -m "YOUR_COMMIT_MESSAGE"
Let's push the changes to your repository! execute the following command to push all the changes to the forked copy in your GitHub account.
git push -u origin YOUR_BRANCH_NAME
Now, open your web browser and go to the original repository on GitHub. If your changes has been pushed to your forked copy, You'll be able to see an option saying "New Pull Request" in the original repository. Click on the option, one next page choose the master branch of the main repository against your created-branch name (choose that branch name which you created and not master). Then click on create pull request. Once you fill in the commit message and comment click on submit pull request.
Finally you are all done! Wait for a reviewer to review your file and merge it to the master.
Once, you have learned about pull request and GitHub, you need to make 4 pull requests to any open-source projects. But a word of caution, your pull requests should only have commits by you, also, pull requests reported as spam would not be eligible.
After you make your pull requests, contribute by finding bugs and remove them and finally pushing them in the repository. Also, you can check your progress on the Hacktoberfest website!
The event is a great opportunity to grow as a developer and improve your skills, also if you make 1 successful pull requests gets merged, you are eligible to get a really cool T-Shirt by mail. We can't wait to see what you contribute!
Whether this is your first or hundredth open-source contribution, we are excited to be part of your journey. And remember, a contribution doesn't always have to be about code, some of the most valuable contributions to a project are often not code related.
If you have any questions about anything in this blog post or as you embark on your open-source quest, feel free to reach out!
Happy Coding !!
If you have any questions, do let us know in the comment section below!