Awesome-Python-Scripts/CONTRIBUTING.md
Rudraksh Karpe 246b646e69
docs: updated CONTRIBUTING.md guildlines
- Fixed minor errors in previous CONTRIBUTING.md
- Updated commit message conventions
2023-10-05 03:04:16 +05:30

2.4 KiB

Contributing to Awesome Python Scripts

First off, thanks for taking the time to contribute!

All types of contributions are encouraged and valued. Please make sure to read the relevant section before making your contribution. It will make it a lot easier for the maintainers and smooth out the experience for all involved. The community looks forward to your contributions. 🎉

Steps for Contribution

1. Fork this repository

Fork this repository by clicking on the fork button on the top of this page. This will create a copy of this repository in your account.

2. Clone the forked repository

In your cloned repository click on the green code button and copy the link shown.

Clone your forked repository by running the git clone command with you copied link on you command line.

git clone <url_you_just_copied>

Do the following command to get into the repository directory:

cd <your_directory>

Then create your own branch in the repo using:

git checkout -b <your_branch_name>

3. Add your changes

You can see what all you changes using the git status command.

4. Add all you changes

Add all your changes to you branch using the git add . command

5. Commit your changes

Commit your changes to your branch using git commit -m "commit message" command.

Commit Message Conventions

  • Start with a short summary (50 characters or less) of the changes made.
  • Use the present tense and imperative mood.
  • Separate the summary from the body of the message with a blank line.
  • Use the body to explain what and why changes were made, as well as any necessary details.
  • Additionally, you can consider using semantic commit messages like "feat:", "docs:", etc. which will provide additional context to the commit message.
Commit Type Description
feat New feature or functionality added
fix Bug fix
docs Changes to documentation
test Adding or updating tests
chore Maintenance tasks such as refactoring, dependencies updates, or removing unused code
ci Changes to the build or continuous integration process

5. Push you changes to GitHub

Switch to the master branch using this command:

git checkout master

Push all your changes to GitHub using the command:

git push --set-upstream origin <your_branch_name>