34282926a1
## What Generates version 2.0 of the Airbyte platform documentation using Docusaurus's built-in versioning system. This creates a frozen snapshot of the current documentation that users can reference. Requested by ian.alton@airbyte.io via [Slack thread](https://airbytehq-team.slack.com/archives/D08FX8EC9L0/p1760490197805979?thread_ts=1760490197.805979). Link to Devin run: https://app.devin.ai/sessions/689693593bac44f4903f476aa17b872e ## How - Ran `pnpm run docusaurus docs:version:platform 2.0` in the docusaurus directory - This automatically: - Created `platform_versioned_docs/version-2.0/` containing a snapshot of all current platform docs - Created `platform_versioned_sidebars/version-2.0-sidebars.json` with the sidebar navigation structure - Updated `platform_versions.json` to add "2.0" to the version list - Ran prettier to format the JSON files - Verified the documentation builds successfully locally (build completed in ~3 minutes with only pre-existing broken anchor warnings) ## Review guide 1. **Verify timing**: Confirm this is the correct time to release version 2.0 of the documentation 2. **Version order**: Check `docusaurus/platform_versions.json` - verify "2.0" is first in the array (newest version first) 3. **Build verification**: Ensure CI/Vercel builds pass without errors 4. **Spot check**: Optionally review 2-3 files in `docusaurus/platform_versioned_docs/version-2.0/` to ensure content looks reasonable Note: This is a standard Docusaurus versioning operation that creates a frozen snapshot of the current "next" documentation. The generated files are extensive (500+ files) but follow Docusaurus conventions. ## User Impact Users will see version 2.0 available in the version dropdown on docs.airbyte.com. This provides a stable reference point for platform documentation at this point in time. Existing versions (1.6, 1.7, 1.8) remain unchanged. ## Can this PR be safely reverted and rolled back? - [x] YES 💚 This is an additive change that doesn't modify existing versioned docs. Reverting would simply remove version 2.0 from the version list and delete the associated documentation files. Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Co-authored-by: ian.alton@airbyte.io <ian.alton@airbyte.io>
3.3 KiB
products
| products |
|---|
| all |
Add and manage sources
A source is the database, API, or other system from which you sync data. Adding a source connector is the first step when you want to start syncing data with Airbyte.
Add a source connector
Add a new source connector to Airbyte.
-
In the left navigation, click Sources.
-
Click New Source.
-
Find the source you want to add. If you're not sure yet, click the Marketplace tab, then click Sample Data (Faker). Faker is a popular test source that generates random data.
-
Configure your connector using the form on the left side of your screen. Every connector has different options and settings, but you normally enter things like authentication information and the location where you store your data. Use the documentation panel on the right side of your screen for help populating the form.
-
Click Set up source. Airbyte tests the source to ensure it can make a connection. Once the test completes, Airbyte takes you to the New Connection page, where you can set up a new destination connector, or choose one you previously created.
Modify a source connector
After you set up a source connector, you can modify it.
-
In the left navigation, click Sources.
-
Find and click the source connector you want to modify.
-
Configure your connector using the form on the left side of your screen. Every connector has different options and settings, but you normally enter things like authentication information and the location where you store your data. Use the documentation panel on the right side of your screen for help populating the form.
-
Click Test and save. Airbyte tests the source to ensure it can make a connection.
Delete a source connector
You can delete a source you no longer need.
:::danger Deleting a source connector also deletes any connections that rely on it. Data that's already in your destination isn't affected. However, reestablishing this connection later requires a full re-sync. :::
-
In the left navigation, click Sources.
-
Find and click the source connector you want to modify.
-
Click Delete this source.
-
In the dialog, type the name of the connector, then click Delete.
Reusing source connectors
Connectors are reusable. In most cases, you only need to set up the connector once, and you can use it in as many connections as you need to.
In a few cases, you might need to set up the same source connector multiple times. For example, if you are pulling data from multiple accounts that have unique authentication, you need a separate connector for each account.
If you don't see the connector you need
If Airbyte doesn't have the connector you need, you can create your own. In most cases, you want to use the Connector Builder, a no-code/low-code development environment in Airbyte's UI.
Other ways to manage sources
Airbyte has other options to manage connectors, too.
In these cases, you can speed up the process by entering your values into the UI, then clicking the Copy JSON button. This copies your configuration as a JSON string that you can paste into your code.