[Docs] March 2024 Release Notes (#36871)

Co-authored-by: Natik Gadzhi <natik@respawn.io>

docs/cloud/managing-airbyte-cloud/manage-airbyte-cloud-notifications.md

@@ -10,81 +10,74 @@ This page provides guidance on how to manage notifications for Airbyte, allowing
 
 | Type of Notification   | Description                                                                                                         |
 |------------------------|---------------------------------------------------------------------------------------------------------------------|
-| Failed Syncs                          | A sync from any of your connections fails. Note that if sync runs frequently or if there are many syncs in the workspace these types of events can be noisy            |
-| Successful Syncs                      | A sync from any of your connections succeeds. Note that if sync runs frequently or if there are many syncs in the workspace these types of events can be noisy
-| Automated Connection Updates          | A connection is updated automatically (ex. a source schema is automatically updated)              |
-| Connection Updates Requiring Action   | A connection update requires you to take action (ex. a breaking schema change is detected)                |
-| Warning - Repeated Failures                 | A connection will be disabled soon due to repeated failures. It has failed 50 times consecutively or there were only failed jobs in the past 7 days               |
-| Sync Disabled - Repeated Failures                         | A connection was automatically disabled due to repeated failures. It will be disabled when it has failed 100 times consecutively or has been failing for 14 days in a row               |
-| Warning - Upgrade Required (Cloud only)                         |       A new connector version is available and requires manual upgrade       |
-| Sync Disabled - Upgrade Required (Cloud only)                         |   One or more connections were automatically disabled due to a connector upgrade deadline passing
+| **Failed Syncs**                          | A sync from any of your connections fails. Note that if sync runs frequently or if there are many syncs in the workspace these types of events can be noisy            |
+| **Successful Syncs**                      | A sync from any of your connections succeeds. Note that if sync runs frequently or if there are many syncs in the workspace these types of events can be noisy
+| **Automated Connection Updates**          | A connection is updated automatically (ex. a source schema is automatically updated)              |
+| **Connection Updates Requiring Action**   | A connection update requires you to take action (ex. a breaking schema change is detected)                |
+| **Warning - Repeated Failures**                 | A connection will be disabled soon due to repeated failures. It has failed 50 times consecutively or there were only failed jobs in the past 7 days               |
+| **Sync Disabled - Repeated Failures**                         | A connection was automatically disabled due to repeated failures. It will be disabled when it has failed 100 times consecutively or has been failing for 14 days in a row               |
+| **Warning - Upgrade Required** (Cloud only)                         |       A new connector version is available and requires manual upgrade       |
+| **Sync Disabled - Upgrade Required** (Cloud only)                         |   One or more connections were automatically disabled due to a connector upgrade deadline passing
+
+### Enabling schema update notifications
+
+To be notified of any source schema changes, make sure you have enabled `Automatic Connection Updates` and `Connection Updates Requiring Action` notifications. If these are off, even if you turned on schema update notifications in a connection's settings, Airbyte will *NOT* send out any notifications related to these types of events.
+
+To edit this setting, click **Connections** and select the connection you want to receive notifications for. Click the **Settings** tab on the Connection page. In the **Advanced Settings**, toggle **Schema update notifications**.
+
 
 ## Configure Email Notification Settings
 
 <AppliesTo cloud />
 
-To set up email notifications:
+To set up email notifications, click **Settings** and navigate to **Workspace** > **Notifications**.
 
-1. In the Airbyte UI, click **Settings** and navigate to **Notifications**.
+Toggle which messages you'd like to receive from Airbyte. All email notifications will be sent by default to the creator of the workspace. 
 
-2. Toggle which messages you'd like to receive from Airbyte. All email notifications will be sent by default to the creator of the workspace. To change the recipient, edit and save the **notification email recipient**. If you would like to send email notifications to more than one recipient, you can enter an email distribution list (ie Google Group) as the recipient.
-
-3. Click **Save changes**.
+![](./assets/notifications-email.png)   
 
 :::note
 All email notifications except for Successful Syncs are enabled by default. 
 :::
 
+### Modify the email recipient
+To change the recipient, edit and save the **notification email recipient**. If you would like to send email notifications to more than one recipient, you can enter an email distribution list (ie Google Group) as the recipient.
+
 ## Configure Slack Notification settings
 
-To set up Slack notifications:
-
-If you're more of a visual learner, just head over to [this video](https://www.youtube.com/watch?v=NjYm8F-KiFc&ab_channel=Airbyte) to learn how to do this. You can also refer to the Slack documentation on how to [create an incoming webhook for Slack](https://api.slack.com/messaging/webhooks).
+If you're more of a visual learner, head over to [this video](https://www.youtube.com/watch?v=NjYm8F-KiFc&ab_channel=Airbyte) to learn how to do this. You can also refer to the Slack documentation on how to [create an incoming webhook for Slack](https://api.slack.com/messaging/webhooks).
 
 ### Create a Slack app
 
-1. **Create a Slack App**: Navigate to https://api.slack.com/apps/. Select `Create an App`. 
+1. To set up Slack notifications, navigate to https://api.slack.com/apps/. Select `Create an App`. 
 
-![](../../.gitbook/assets/notifications_create_slack_app.png)   
+![](./assets/notification-slack-create-app.png)   
 
 2. Select `From Scratch`. Enter your App Name (e.g. Airbyte Sync Notifications) and pick your desired Slack workspace. 
 
-3. **Set up the webhook URL.**: in the left sidebar, click on `Incoming Webhooks`.  Click the slider button in the top right to turn the feature on. Then click `Add New Webhook to Workspace`.
+3. **Enable Incoming Webhooks**: in the left sidebar, click on `Incoming Webhooks`.  Click the slider button in the top right to turn the feature on. Then click `Add New Webhook to Workspace`.
 
-![](../../.gitbook/assets/notifications_add_new_webhook.png)
+![](./assets/notification-slack-add-webhook.png)   
 
-4. Pick the channel that you want to receive Airbyte notifications in (ideally a dedicated one), and click `Allow` to give it permissions to access the channel. You should see the bot show up in the selected channel now. You will see an active webhook right above the `Add New Webhook to Workspace` button.
+4. Select the channel that you want to receive Airbyte notifications in (ideally a dedicated one), and click `Allow` to give it permissions to access the channel. You should see the bot show up in the selected channel now. You will see an active webhook right above the `Add New Webhook to Workspace` button.
 
-![](../../.gitbook/assets/notifications_webhook_url.png) 
+![](./assets/notification-slack-webhook-url-success.png)   
 
 5. Click `Copy.` to copy the link to your clipboard, which you will need to enter into Airbyte.
 
-Your Webhook URL should look something like this:
-
-![](../../.gitbook/assets/notifications_airbyte_notification_settings.png)
+Your Webhook URL should look similar to this:
 
+ ``` 
+ https://hooks.slack.com/services/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PM1
+ ``` 
 
 ### Enable the Slack notification in Airbyte
 
-1. In the Airbyte UI, click **Settings** and navigate to **Notifications**.
+1. Click **Settings** and navigate to **Notifications**. On this page, you can toggle each slider decide whether you want notifications on each notification type. Paste the copied webhook URL to `Webhook URL`. 
 
-2. Paste the copied webhook URL to `Webhook URL`. Using a Slack webook is recommended. On this page, you can toggle each slider decide whether you want notifications on each notification type. 
+3. **Test it out**: you can click `Test` to send a test message to the channel. Or, just run a sync now and try it out! For a successful sync, you should receive a notification that looks like this:
 
-3. **Test it out.**: you can click `Test` to send a test message to the channel. Or, just run a sync now and try it out! If all goes well, you should receive a notification in your selected channel that looks like this:
+![](./assets/notification-slack-success.png)
 
-![](../../.gitbook/assets/notifications_slack_message.png)
 
-You're done!
-
-4. Click **Save changes**.
-
-## Enable schema update notifications
-
-To be notified of any source schema changes: 
-1. Make sure you have enabled `Automatic Connection Updates` and `Connection Updates Requiring Action` notifications. If these are off, even if you turned on schema update notifications in a connection's settings, Airbyte will *NOT* send out any notifications related to these types of events.
-
-2. In the Airbyte UI, click **Connections** and select the connection you want to receive notifications for.
-
-3. Click the **Settings** tab on the Connection page.
-
-4. Toggle **Schema update notifications**.
+4. Click **Save changes** to ensure you continue to receive alerts about your Airbyte syncs.

docs/cloud/managing-airbyte-cloud/manage-credits.md

@@ -8,15 +8,15 @@ Airbyte [credits](https://airbyte.com/pricing) are used to pay for Airbyte resou
 
 ## Buy credits
 
-To purchase credits directly through the UI, 
+1. To purchase credits directly through the UI, click **Billing** in the left-hand sidebar. The billing page displays the available credits, total credit usage, and the credit usage per connection. 
 
-1. Click **Billing** in the left-hand sidebar.
+    :::tip
 
-2. If you are unsure of how many credits you need, use our [Cost Estimator](https://www.airbyte.com/pricing) or click **Talk to Sales** to find the right amount for your team.
+    If you are unsure of how many credits you need, use our [Cost Estimator](https://www.airbyte.com/pricing) or click **Talk to Sales** to find the right amount for your team.
 
-3. Click **Buy credits**.
+    :::
 
-4. Determine the quantity of credits you intend to purchase. Adjust the **credit quantity**. When you're ready, click **Checkout**.
+2. Click **Buy credits**. Enter the quantity of credits you intend to purchase and adjust the **credit quantity** accordingly. When you're ready, click **Checkout**.
 
     :::note 
 
@@ -30,11 +30,7 @@ To purchase credits directly through the UI,
 
 5. You'll be renavigated to a Stripe payment page. If this is your first time purchasing, you'll be asked for payment details. After you enter your billing address, sales tax (if applicable) is calculated and added to the total.
 
-6. Click **Pay**.
-    
-    Your payment is processed. The Billing page displays the available credits, total credit usage, and the credit usage per connection. 
-
-    A receipt for your purchase is sent to your email. 
+6. Click **Pay** to process your payment. A receipt for your purchase is automatically sent to your email. 
 
     :::note 
 

docs/cloud/managing-airbyte-cloud/manage-data-residency.md

@@ -18,15 +18,7 @@ While the data is processed in a data plane of the chosen residency, the cursor
 
 When you set the default data residency, it applies your preference to new connections only. If you do not adjust the default data residency, the [Airbyte Default](configuring-connections.md) region is used (United States).  If you want to change the data residency for an individual connection, you can do so in its [connection settings](configuring-connections.md).
 
-To choose your default data residency:
-
-1. In the Airbyte UI, click **Settings**.
-
-2. Click **Data Residency**.
-
-3. Click the dropdown and choose the location for your default data residency.
-
-4. Click **Save changes**. 
+To choose your default data residency, click **Settings** in the Airbyte UI. Navigate to **Workspace** > **Data Residency**. Use the dropdown to choose the location for your default data residency and save your changes.
 
 :::info 
 
@@ -37,15 +29,7 @@ Depending on your network configuration, you may need to add [IP addresses](/ope
 ## Choose the data residency for a connection
 You can additionally choose the data residency for your connection in the connection settings. You can choose the data residency when creating a new connection, or you can set the default data residency for your workspace so that it applies for any new connections moving forward.
 
-To choose a custom data residency for your connection: 
-
-1. In the Airbyte UI, click **Connections** and then click the connection that you want to change. 
-
-2. Click the **Settings** tab. 
-
-3. Click the **Data residency** dropdown and choose the location for your default data residency.
-
-4. Click **Save changes**
+To choose a custom data residency for your connection, click **Connections** in the Airbyte UI and then select the connection that you want to configure. Navigate to the **Settings** tab, open the **Advanced Settings**, and select the **Data residency** for the connection.
 
 :::note