Contributing to Airbyte

Thank you for your interest in contributing! Contributions are very welcome. We appreciate first time contributors and we are happy help you get started. Join our community Slack and feel free to reach out with questions in #dev-and-contribuions channel.

Everyone interacting in Slack, codebases, mailing lists, events, or any other Airbyte activities is expected to follow the Code of Conduct. Please review it before getting started.

Code Contributions

Most of the issues that are open for contributions are tagged with good first issue or help-welcome. If you see an issue that isn't tagged that you're interested in, post a comment with your approach, and we'd be happy to assign it to you. If you submit a fix isn't linked to an issue you're assigned there is chance it won't be accepted. You can ping @marcosmarxm who is responsible for Community Code Contributions.

Here are the areas that we love seeing contributions to:

• Bug fixes, features, and enhancements to existing API source connectors.
• New API sources built with the Connector Builder.
• New streams and features for existing connectors in Connector Builder: error backoff, pagination, incremental syncs, etc.
• Migrating existing sources from Python to the Connector Builder.
• Bug fixes, features, and enhancements to the following database sources: Postgres, MySQL, MSSQL.
• Bug fixes to the following destinations: BigQuery, Snowflake, Redshift, S3, and Postgres.
• Helm Charts features, bug fixes, and other platform bug fixes.

Please be aware that contributions to Airbyte Connectors may take some time to review, as they can affect many users. We appreciate your patience and encourage you to include as much information as possible to assist reviewers. Please add examples, use cases, documentation links, and more.

:::warning Airbyte is revamping its core Java destinations codebase. We're not reviewing/accepting new Java connectors at this time. :::

The usual workflow of code contribution is:

1. Fork the Airbyte repository.
2. Clone the repository locally.
3. Create a branch for your feature/bug fix with the format {YOUR_USERNAME}/{FEATURE/BUG} (e.g. jdoe/source-stock-api-stream-fix)
4. Make and commit changes.
5. Push your local branch to your fork.
6. Submit a Pull Request so that we can review your changes.
7. Link an existing Issue that does not include the needs triage label to your Pull Request. Pull requests without an issue attached take longer to review.
8. Write a PR title and description that follows the Pull Request Handbook.
9. An Airbyte maintainer will trigger the CI tests for you and review the code.
10. Review and respond to feedback and questions by Airbyte maintainers.
11. Merge the contribution.

You can check the status of your contribution in this Github Project. It will provide you what Sprint your contribution was assigned and when you can expect a review.

:::warning Do not submit a pull request using the master branch from your forked repository. The team will not be able to run integration tests and your pull request will be closed. :::

Guidelines to common code contributions:

• Contribute a code change to an existing connector
• Contribute a new connector

Documentation

We welcome pull requests that fix typos or enhance the grammar and structure of our documentation! Check the Updating Documentation guide for details on submitting documentation changes.

The following highlights from the Google developer documentation style guide are helpful for new writers:

• Be conversational and friendly without being frivolous
• Use second person
• Use active voice
• Put conditional clauses before instructions
• Put UI elements in bold
• Write inclusive documentation
• Don't pre-announce anything in documentation

Guideline for visuals: Use links to videos instead of screenshots (Reason: Users are more forgiving of outdated videos than screenshots).

For examples of good connector docs, see the Salesforce source connector doc and Snowflake destination connector doc

Community Content

We welcome contributions as new tutorials / showcases / articles, or as enhancements to any of the existing guides on our tutorials page. Head to this repo dedicated to community content: Write for the Community.

Feel free to submit a pull request in this repo, if you have something to add even if it's not related to anything mentioned above.

Engage with the Community

Another crucial way to contribute is by reporting bugs and helping other users in the community. You're welcome to join the Community Slack. Refer to our Issues and Feature Requests guide to learn about the best ways to report bugs.