View Source Contributing 🎉

Hi there! We are thrilled that you'd like to contribute to this project. Your help is essential for keeping it great 🙌.

Contributions to this project are released to the public under the project's open source license.

Here are a few things you can do that will increase the likelihood of your pull request being accepted:

  • Follow standards for style and code quality.
  • Write tests (if applicable).
  • Keep your change as focused as possible. If there are multiple changes you would like to make that are not dependent upon each other, consider submitting them as separate pull requests.
  • Write a good commit message.
  • All content, comments, pull requests and other contributions must comply with the code of conduct.

getting-started

Getting started

  • Make sure you have a GitHub account.
  • Create a GitHub issue for your contribution, assuming one does not already exist.
    • Choose one of the templates and clearly describe the issue.
  • Fork the repository on GitHub.
  • Try to keep your local repository in a "rebased" state.

finding-things-to-work-on

Finding things to work on

Issues marked with good first issue or help wanted are usually pretty self-contained and a good place to get started.

If you see any issues that are assigned to a particular person or have the work in progress label, that means someone is currently working on that issue this issue in the next week or two.

Of course, feel free to create a new issue if you think something needs to be added or fixed.

making-changes

Making changes

  • Create a topic branch from where you want to base your work git checkout -b my-branch-name.
    • This is usually the main branch.
    • Please avoid working directly on the main branch.

submitting-changes

Submitting changes

  • Push changes to your fork.
  • Submit a pull request.

At this point, you're waiting on us. We like to at least comment on pull requests within three business days (typically, one business day). We may suggest some changes, improvements or alternatives.

Stale issues

To ensure that our issue tracker remains organized and relevant, we have implemented a policy for handling Stale issues. Please review the following guidelines:

  1. Marking as Stale: Issues will be automatically marked as Stale after 60 days of inactivity.
  2. Closing Stale Issues: After an issue has been marked as Stale, a comment will be posted on the issue indicating that it will be closed if there is no further activity or information provided within a specified period.

Thank you for helping us maintain a clean and efficient issue tracker!

resources

Resources

contact

Contact

Get in touch: oss@kommit.co | @kommitters_oss on Twitter.