Skip to content
Permalink
Branch: master
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
60 lines (39 sloc) 3.67 KB

Contributing to Featuretools

👍🎉 First off, thank you for taking the time to contribute! 🎉👍

Whether you are a novice or experienced software developer, all contributions and suggestions are welcome!

There are many ways to contribute to Featuretools, with the most common ones being contribution of code or documentation to the project.

To contribute, you can:

  1. Help users on our Slack channel. Answer questions under the featuretools tag on Stack Overflow

  2. Submit a pull request for one of Good First Issues

  3. Make changes to the codebase, see Contributing to the codebase.

  4. Improve our documentation, which can be found under the docs directory or at https://docs.featuretools.com

  5. Report issues you're facing, and give a "thumbs up" on issues that others reported and that are relevant to you. Issues should be used for bugs, and feature requests only.

  6. Spread the word: reference Featuretools from your blog and articles, link to it from your website, or simply star it in GitHub to say "I use it".

Contributing to the Codebase

Before starting major work, you should touch base with the maintainers of Featuretools by filing an issue on GitHub or posting a message in the #development channel on Slack. This will increase the likelihood your pull request will eventually get merged in.

1. Clone repo

  • The code is hosted on GitHub, so you will need to use Git to clone the project and make changes to the codebase. Once you have obtained a copy of the code, you should create a development environment that is separate from your existing Python environment so that you can make and test changes without compromising your own work environment.

2. Implement your Pull Request

  • Implement your pull request. If needed, add new tests or update the documentation.
  • Before submitting to GitHub, verify the tests run and the code lints properly
    # runs test
    make test
    
    # runs linting
    make lint
    
    # will fix some common linting issues automatically
    make lint-fix
  • If you made changes to the documentation, build the documentation locally.
    # go to docs and build
    cd docs
    make html
    
    # view docs locally
    open build/html/index.html

3. Submit your Pull Request

  • Once your changes are ready to be submitted, make sure to push your changes to GitHub before creating a pull request. Create a pull request, and our continuous integration will run automatically. We will review your changes, and you will most likely be asked to make additional changes before it is finally ready to merge. However, once it's reviewed by a maintainer of Featuretools, passes continuous integration, we will merge it, and you will have successfully contributed to Featuretools!

Report issues

When reporting issues please include as much detail as possible about your operating system, featuretools version and python version. Whenever possible, please also include a brief, self-contained code example that demonstrates the problem.

You can’t perform that action at this time.