Skip to content
This repository has been archived by the owner on Feb 1, 2024. It is now read-only.

Latest commit

 

History

History
58 lines (43 loc) · 2.47 KB

CONTRIBUTING.md

File metadata and controls

58 lines (43 loc) · 2.47 KB
Raw

How to Contribute

We'd love to accept your patches and contributions to this project. DSP can be subtle to get completely right, so we particularly appreciate the contributions of those with expertise in signal processing to help fix any mistakes we may have made 😄.

Code Design Goals

As much as we can, we would like the DDSP library to be approachable, well-tested, well-documented, and full of useful examples. Thus, PRs that add new functionality should be accompanined with ample documentation and tests to help newcomers understand a typical use case, and guard against silent failures from breaking changes in the future. Please follow the existing doc/testing style when you can.

To ensure a consistent style, new code should follow the Google's Python Style Guide and will need to pass a google style linter before acceptance. While this can add a little work up front, and occasionally make things more verbose, it helps reduce mental overhead and makes the code more readable.

Code reviews

All submissions, including submissions by project members, require review. We use GitHub pull requests for this purpose. Consult GitHub Help for more information on using pull requests.

Please be sure to test your code by running pylint before submitting a pull request for review.

Getting Started

If you're looking for a way to contribute, but not sure where to start, you could:

  • Add some documentation to an existing function.
  • Add a missing test to improve coverage.
  • Add type hints to functions in a new file.
  • Add a new colab tutorial or demo, covering a typical use case or showing something cool.
  • Respond to a bug or feature request in the github Issues.

Contributor License Agreement

Contributions to this project must be accompanied by a Contributor License Agreement. You (or your employer) retain the copyright to your contribution; this simply gives us permission to use and redistribute your contributions as part of the project. Head over to https://cla.developers.google.com/ to see your current agreements on file or to sign a new one.

You generally only need to submit a CLA once, so if you've already submitted one (even if it was for a different project), you probably don't need to do it again.

Community Guidelines

This project follows Google's Open Source Community Guidelines.