initial pass of Einsteam feedback fixes

Author: forstisabella

src/unified-profiles/create-sql-traits.md

@@ -66,7 +66,7 @@ FROM
     <database_name.contact_table> c
 WHERE 
     c.PHONE IS NOT NULL
-    AND c.BILLING_COUNTRY IS NOT NULL;
+    AND c.MAILING_COUNTRY IS NOT NULL;
 ```
 
 After running this query, you can use ‘phone’ for lookups in Unified Profiles.    
@@ -95,7 +95,7 @@ FROM
     <database_name.lead_table> l
 WHERE 
     l.PHONE IS NOT NULL
-    AND l.BILLING_COUNTRY IS NOT NULL;
+    AND l.COUNTRY IS NOT NULL;
 ```
 
 After running this query, you can use ‘phone’ for lookups in Unified Profiles.  

src/unified-profiles/segment-for-flex.md

@@ -38,7 +38,11 @@ You can add additional data sources after completing the setup process. <br>
 5. Give your destination a name and enter the account credentials for a user that has read and write permissions. Click **Save**. 
 6. After you've given your destination a name and entered your credentials, click **Next**.
 7. On the Getting started with Segment page, click **Define Model**.
-8. [Create a SQL query that defines your model](/docs/unified-profiles/create-sql-traits){:target="_blank"}. After you've created a model, Segment uses your model to map data to your Reverse ETL destinations. 
+8. Create a SQL query that defines your model. After you've created a model, Segment uses your model to map data to your Reverse ETL destinations.
+
+> info "Sample queries for importing records into Unified Profiles"
+> Not sure where to start with the SQL queries that define your model? See the [RETL Queries for Importing Salesforce Objects into Unified Profiles in Flex](/docs/unified-profiles/create-sql-traits){:target="_blank"} documentation.
+ 
 <ol style="counter-reset: none;">
   <li value="9" markdown=1>
   Click **Preview** to return 10 records from your warehouse. When you've verified that your records return as expected, click **Next**.
@@ -51,6 +55,8 @@ You can add additional data sources after completing the setup process. <br>
   </li>
 </ol>
 
+> warning "Records from your data warehouse and Salesforce might not be immediately available"
+> Segment's initial sync with your data warehouse might take up to 24 hours to complete. Segment syncs with Salesforce immediately after you connect it to your Segment for Flex workspace, and every three hours afterward. For more information, see the [Known limitations](#known-limitations) documentation.
 
 ### Data warehouse only
 
@@ -72,6 +78,9 @@ You can add additional data sources after completing the setup process. <br>
   </li>
 </ol>
 
+> warning "Records from your data warehouse might not be immediately available"
+> Segment's initial sync with your data warehouse might take up to 24 hours to complete. For more information, see the [Known limitations](#known-limitations) documentation. 
+
 ### Website or mobile app
 
 Connect to either a website or mobile app to complete this step.
@@ -96,7 +105,10 @@ Connect to either a website or mobile app to complete this step.
 5. After Segment marks the "Add connections" tile as complete, click **Add identifiers and traits** and begin [Step 3: Add identifiers and traits](#step-3-add-identifiers-and-traits).
 
 ## Step 3: Add identifiers and traits
-After you've selected which data sources you'd like to integrate customer data from, you can select _identifiers_, or unique pieces of data that allow you to link information about an individual customer across different programs and services, and _traits_, which are pieces of information you know about a particular customer. 
+After you've selected which data sources you'd like to integrate customer data from, you can select _identifiers_, or unique pieces of data that allow you to link information about an individual customer across different programs and services, and _traits_, which are pieces of information you know about a particular customer.
+
+> warning "Records from your data warehouse and Salesforce might not be immediately available"
+> Segment's initial sync with your data warehouse might take up to 24 hours to complete. Segment syncs with Salesforce immediately after you connect it to your Segment for Flex workspace, and every three hours afterward. For more information, see the [Known limitations](#known-limitations) documentation.
 
 1. On the Add identifiers and traits page, click **Add identifier**. 
 2. Select one or more of Segment's 11 default identifiers and click **Add identifiers**.
@@ -192,6 +204,28 @@ Your Segment for Flex workspace has the following entitlements:
 - 2 [Computed traits](/docs/unify/Traits/computed-traits/){:target="_blank"}
 - 2 [Predictions](/docs/unify/traits/predictions/){:target="_blank"}
 
+### Known limitations
+
+#### Salesforce
+
+Segment syncs with Salesforce every three hours, and will run a full historical re-sync on only Objects/Collections, not custom properties or columns. To learn more about how Segment syncs with Salesforce, see the [Syncs](#syncs) documentation. For more information about historical re-syncs, see the [Historical data](#historical-data) documentation. 
+
+###### Syncs
+The Salesforce source contains a sync component, which means Segment makes requests to the Salesforce API on your behalf on a 3 hour interval to pull the latest data into Segment. In the initial sync, Segment downloads all the Salesforce objects (and their corresponding properties) by default. Segment writes the objects into a separate schema, that corresponds to the source instance’s schema name you designated upon creation. For example, you name the schema sfdc_prod, access the leads collection by accessing sfdc_prod.leads in SQL.
+
+The sync component uses an upsert API, so the data in your warehouse loaded using sync will reflect the latest state of the corresponding resource in Salesforce. For example, if ticket_status goes from open to closed between syncs, on its next sync that tickets status will be closed.
+
+##### Historical data
+When a new Object/Collection is enabled, Segment automatically runs a full historical re-sync on that Object. However, for custom properties/columns, Segment only populates the custom property with data that comes in after the custom field was enabled. In order to populate the new custom field(s) for records that have previously been synced, you need to initiate a manual re-sync.
+
+> info ""
+> Initiating a full re-sync might impact your workspace’s API calls + Object usage.
+
+Segment uses the SystemModstamp (`system_modstamp`) field to checkpoint collections that sync incrementally. When enabled, Segment syncs collections incrementally. When disabled, Segment syncs collections fully. If you’d like to force a collection to sync fully on the next run to bring in historical data, you can disable the SystemModstamp field on the collection, allow the next sync to complete, and then re-enable SystemModstamp so the collection syncs incrementally in the coming syncs.
+
+#### Warehouses
+Segment guarantees that your data will be available in your warehouse within 24 hours. 
+
 <div class="double">
   {% include components/reference-button.html
     href="/docs/unified-profiles/"