Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. But it is also important to follow the best practices so that there is no confusion.
For beginners, who are starting out with their first contributions, it might seem a bit tricky to work with GitHub, especially if you have no previous knowledge of Git.
So, here are a couple of resources to help you refresh / get started:
- Git Cheatsheet
- GitHub Learning Lab
- ZBunker's Complete Git Tutorial (recommended if you are willing to devote some time)
YouTubeBot relies on Python as its core language. So, inorder to make contributions, you are expected to know the basics of Python. Here is a great playlist to start with.
YouTubeBot is evolving at a very fast rate. So many changes are being made to make it adaptive and upto date. This means, we change/update our documentations very often. Keeping a proper and neat documentation is what we are after. For those contributing towards documentation, knowing Markdown will be of great help.
Here are some resources for you to get started:
You are free to choose your style of workflow as far as you are not making a PR from the main branch of your fork. This is not recommended and would create some problems while syncing your fork with the upstream repository.
For beginners, here's what you'd have to do:
- Fork the Project
- Clone your fork to your local machine via
git clone https://github.com/YOUR_USERNAME/YoutubeBot.git
- Create a branch in your local machine:
git checkout -b <YOUR_BRANCH_NAME>
- Make changes/commits to this branch
git commit -m "SOME_USEFUL_MSG_WITH_ISSUE_CODE"
- Push changes to your fork:
git push origin <YOUR_BRANCH_NAME>
- Create a PR from your fork to YouTubeBot main branch
We love our commits to look similar and homogeneous. We recently started following conventionalcommits guidelines to craft our commit messages. You too can follow this guide at https://www.conventionalcommits.org/