This repository is for anyone around the globe who wants to start their open-source journey with Hacktoberfest. The purpose of this repository is to learn and share knowledge.
We do not recommend adding just a white-space or Hello World application. Please try to keep your contribution good, as we believe in Quality, and not Quantity. We'll thoroughly go through each PR, and if it doesn't have quality, it won't be accepted.
Hacktoberfest is a global challenge organized by DigitalOcean. It encourages participation in giving back to the open-source community by completing pull requests and participating in events. You can sign up anytime between 1 and October 31. Pull requests can be submitted to this repo or any opted-in GitHub or GitLab repo. To get a T-shirt 👕, you must make 4 approved pull requests (PRs). 🎉
Here, we have mentioned the instructions to set up git. If you don't already know what Git is, check out this blog series on iRead.
- Login / Sign-up to Github.
- Download and install Git.
- Configure git
- Launch terminal or command promt.
- Run the commands.
git config --global user.name "Your name"git config --global user.email "Your email address"
- Optionally, you can setup ssh keys to authenticate easily.
You are free to select any topic such as Python, Machine Learning, Deep Learning, Computer Vision, Web Development, etc. Your contribution can be your mini-project, algorithms, solution to coding problem, etc. Just make sure to follow the below guidelines strictly.
Refer to Contributing Guidelines to learn how to setup the repository.
Once you are ready with the setup, follow the below guidelines:
-
Create a folder inside contributions folder with the Topic Name in snake case, i.e., if your topic is URL Shortener using Flask, the folder name should be url_shortener_using_flask.
-
Create a markdown file called README.md inside the folder and describe your topic. The description can be Problem statement of your code, Algorithm description, or something that is relevant to your code.
-
Also, add screenshots, or codes, or Jupyter notebooks inside the same folder.
-
After adding these files, you need to add yourself as contributor.
- Go to
resources/contributors.jsonfile, where you will find other contributor details as:
{
"contributors": [
{
"name": "Ashutosh Krishna",
"github_username": "ashutoshkrris",
"image_url": "https://avatars.githubusercontent.com/u/47353498?v=4",
"title": "Python API Tutorial",
"short_description": "In this Python API tutorial, we’ll learn how to retrieve data using requests library. There are millions of APIs online which provide access to data.",
"page_url": "https://contribute.devincept.com/Hacktoberfest-Contribution/contributions/python-api-tutorial/",
"folder_url":"https://github.com/Learn-Write-Repeat/Hacktoberfest-Contribution/tree/master/contributions/python-api-tutorial"
}
]
}- Within the contributors array, add your details in the form of map/dictionary as :
{
"contributors":[
{
"name": "Ashutosh Krishna",
"github_username": "ashutoshkrris",
"image_url": "https://avatars.githubusercontent.com/u/47353498?v=4",
"title": "Python API Tutorial",
"short_description": "In this Python API tutorial, we’ll learn how to retrieve data using requests library. There are millions of APIs online which provide access to data.",
"page_url": "https://contribute.devincept.com/Hacktoberfest-Contribution/contributions/python-api-tutorial/",
"folder_url":"https://github.com/Learn-Write-Repeat/Hacktoberfest-Contribution/tree/master/contributions/python-api-tutorial"
},
{
"name": "Your Name Here",
"github_username": "Your Github Username Here",
"image_url": "Your Image URL",
"title": "Title of your Contribution",
"short_description": "Short description of your contribution",
"page_url": "https://contribute.devincept.com/Hacktoberfest-Contribution/contributions/<your-folder-name>/",
"folder_url":"https://github.com/Learn-Write-Repeat/Hacktoberfest-Contribution/tree/master/contributions/<your-folder-name>/"
}
]
}Note : For the
folder_urlandpage_url, just replace<your-folder-name>with the name of your folder.