Contributing Guidelines#

Thank you for your interest in contributing to snowexsql! We welcome contributions of any size from anyone regardless of career stage and level of coding experience.

Here we provide a set of guidelines and information for contributing to snowexsql. This project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Contributor Covenant

Ways to Contribute#

Report a Bug#

Find the Issues tab at the top of GitHub repository and click the New Issue button. Give your issue a clear title and describe the steps required to recreate it in as much detail as possible. If you can, include a small example that reproduces the error. More information and minimal examples will help us resolve issues faster.

Asking a Question#

Please do not create issues to ask for help. A faster way to reach the community is through our snowex-sql Discussions page. We are excited to have you join an existing conversation or start a new post!

Write Documentation#

Found a typo in the documentation or have a suggestion to make it clearer? Consider letting us know by creating an issue or (better yet!) submitting a fix. This is a great, low stakes way to practice the pull request process!

Discovered a currently untested case? Please share your test, either by creating an issue or submitting a pull request to add it to our suite of test cases.

Add an Example#

Examples are a great way to show how to use snowexsql. If you have a use case that you think would be helpful to others, please consider adding it to the examples directory.

Request a Feature#

The best way to request a feature is to file an issue at SnowEx/snowexsql#issues.

When requesting a feature, please:

  • Explain in detail how it would work.

  • Keep the scope as narrow as possible, to make it easier to implement.

  • Let us know if this is something you would like to work on!

Contribute Code#

Please see our how to contribute guide on getting started to add your code and ideas.

Licensing#

SnowExSQL is licensed under the BSD-3 license. Contributed code will also be licensed under BSD-3. If you did not write the code yourself, it is your responsibility to ensure that the existing license is compatible and included in the contributed files or you have documented permission from the original author to relicense the code.

Attribution#

See our list of current contributors that have helped shape this project.