polish

Author: forstisabella

src/_data/sidenav/main.yml

@@ -182,6 +182,14 @@ sections:
     section:
     - path: /connections/reverse-etl
       title: Reverse ETL Overview
+    - path: /connections/reverse-etl/setup
+      title: Set up Reverse ETL
+    - path: /connections/reverse-etl/observability
+      title: Observability
+    - path: /connections/reverse-etl/mappings
+      title: Reverse ETL Mappings
+    - path: /connections/reverse-etl/system
+      title: Reverse ETL System
     - path: /connections/reverse-etl/reverse-etl-catalog
       title: Reverse ETL Catalog
     - section_title: Reverse ETL Source Setup Guides

src/connections/reverse-etl/index.md

@@ -5,11 +5,17 @@ redirect_from:
   - '/reverse-etl/'
 ---
 
-Reverse ETL (Extract, Transform, Load) extracts data from a data warehouse using a query you provide and syncs the data to your third party destinations. For example, with Reverse ETL, you can sync records from Snowflake to Mixpanel. Reverse ETL supports event and object data. This includes customer profile data, subscriptions, product tables, shopping cart tables, and more.
+Reverse ETL (Extract, Transform, Load) extracts data from a data warehouse using a query you provide and syncs the data to your third party destinations. 
 
-<!-- TODO: Should we "sell" this more? --->
+Use Reverse ETL when you want to:
+* **Enable your marketing teams**: Sync audiences and other data built in the warehouse to Braze, Hubspot, or Salesforce Marketing Cloud for personalized marketing campaigns.
+* **Enrich your customer profiles**: Sync enriched data to Mixpanel for a more complete view of the customer, or enrich Segment Unify with data from the warehouse.
+* **Activate data in Twilio Engage**: Send data in the warehouse back into Segment as events that can be activated in all supported destinations, including Twilio Engage.
+* **Strengthen your conversion events**: Pass offline or enriched data to conversion APIs like Facebook, Google Ads, TikTok, or Snapchat.
+* **Empower business teams**: Connect Google Sheets to a view in the warehouse for other business teams to have access to up-to-date reports.
 
-![Reverse ETL overview image](images/RETL_Doc_Illustration.png)
+> info "Reverse ETL supports event and object data"
+> Event and object data includes customer profile data, subscriptions, product tables, shopping cart tables, and more.
 
 
 ## Get started with Reverse ETL
@@ -30,40 +36,32 @@ Reverse ETL (Extract, Transform, Load) extracts data from a data warehouse using
   %}
 </div>
 
-## Example use cases
-Use Reverse ETL when you want to:
-* **Enable your marketing teams**: Sync audiences and other data built in the warehouse to Braze, Hubspot, or Salesforce Marketing Cloud for personalized marketing campaigns.
-* **Enrich your customer profiles**: Sync enriched data to Mixpanel for a more complete view of the customer, or enrich Segment Unify with data from the warehouse.
-* **Activate data in Twilio Engage**: Send data in the warehouse back into Segment as events that can be activated in all supported destinations, including Twilio Engage.
-* **Strengthen your conversion events**: Pass offline or enriched data to conversion APIs like Facebook, Google Ads, TikTok, or Snapchat.
-* **Empower business teams**: Connect Google Sheets to a view in the warehouse for other business teams to have access to up-to-date reports.
-
 ## Learn more
 
-Learn more about the observability tools you can use to manage your syncs, the mappings that power the flow of data to your downstream destinations, and the system that powers Segment's Reverse ETL product.
+Learn more about the the system that powers Reverse ETL, the mappings that power the flow of data to your downstream destinations, and observability tools you can use to manage your syncs.
 
 <div class="flex flex--wrap gutter gutter--large">
   <div class="flex__column flex__column--12 flex__column--4@medium">
     {% include components/reference-button.html
       href="/docs/connections/reverse-etl/observability"
       title="Observability"
-      description="The tools that Segment has available"
+      description="View the state of your Reverse ETL syncs and get alerts when things go wrong"
     %}
   </div>
 
   <div class="flex__column flex__column--12 flex__column--4@medium">
     {% include components/reference-button.html
       href="/docs/connections/reverse-etl/mappings"
       title="Mappings"
-      description="Learn more about Reverse ETL mappings"
+      description="Supported objects/arrays and ways to manage your syncs"
     %}
   </div>
 
   <div class="flex__column flex__column--12 flex__column--4@medium">
     {% include components/reference-button.html
-      href="/docs/connections-reverse-etl/system"
+      href="/docs/connections/reverse-etl/system"
       title="System"
-      description="Reverse ETL System reverse ETL system"
+      description="Technical details about how Reverse ETL works"
     %}
   </div>
 </div>

src/connections/reverse-etl/mappings.md

@@ -1,11 +1,11 @@
 ---
-title: Reverse ETL Mappings
+title: Mappings
 beta: false 
 ---
 
-### Managing syncs
+Learn more about supported object and array values in your mappings and how to reset or replay your syncs. 
 
-### Supported object and arrays 
+## Supported object and arrays 
 
 When you set up destination actions in Reverse ETL, depending on the destination, some [mapping fields](#step-4-create-mappings) may require data to be in the form of an [object](#object-mapping) or [array](#array-mapping). 
 
@@ -70,7 +70,7 @@ Select array | This enables you to send all nested properties within the array.
 
 Objects in an array don't need to have the same properties. If a user selects a missing property in the input object for a mapping field, the output object will miss the property. 
 
-#### Reset syncs
+## Reset syncs
 You can reset your syncs so that your data is synced from the beginning. This means that Segment resyncs your entire dataset for the model.
 
 To reset a sync:
@@ -79,5 +79,7 @@ To reset a sync:
 3. Select the checkbox that you understand what happens when a sync is reset.
 4. Click **Reset sync**.
 
-#### Replays
+### Automatic retry handling
+
+## Replays
 You can choose to replay syncs. To replay a specific sync, contact [[email protected]](mailto:[email protected]). Keep in mind that triggering a replay resyncs all records for a given sync.

src/connections/reverse-etl/observability.md

@@ -3,6 +3,8 @@ title: Reverse ETL Observability
 beta: false 
 ---
 
+With the Sync history tab, you can view the status of your data extractions and see details about syncs with your warehouse. 
+
 ## Sync history
 Check the status of your data extractions and see details of your syncs. Click into failed records to view additional details on the error, sample payloads to help you debug the issue, and recommended actions.
 

src/connections/reverse-etl/system.md

@@ -3,6 +3,8 @@ title: Reverse ETL System
 beta: false 
 ---
 
+<!--- TODO: write an intro for this page--->
+
 ## Record diffing
 Reverse ETL computes the incremental changes to your data directly within your data warehouse. The Unique Identifier column is used to detect the data changes, such as new, updated, and deleted records.