segmentio · sanscontext · Nov 23, 2019 · Nov 23, 2019
@@ -1,6 +1,6 @@
-In Segment, you create a source (or more than one!) for each website or app you want to track. While it's not required that you have a single Source for each server, site or app, we **highly recommend** creating a Source for each unique source of data.
+In Segment, you create a source (or more than one!) for each website or app you want to track. We **highly recommend** creating a Source for each unique source of data (each site, app, or server), though this isn't required.
 
-Sources belong to a workspace, and the URL for a source look something like this:
+Sources belong to a workspace, and the URL for a source looks something like this:
 `https://segment.com/<my-workspace>/sources/<my-source-name>/`
 
 You can create new sources using the button in the workspace view. Each source you create has a write key, which is used to send data to that source. For example, to load [`analytics.js`, the Segment JavaScript library](https://segment.com/docs/connections/sources/catalog/libraries/website/analytics.js/) on your page, the snippet on the [Quickstart Guide](https://segment.com/docs/connections/sources/catalog/libraries/website/analytics.js/quickstart/) includes:

@@ -2,33 +2,15 @@
 title: Connections Overview
 ---
 
+Connections is Segment's core product offering: you can collect event data from your mobile apps, websites, and servers with one API, then pull in contextual data from cloud apps like your CRM, payment systems, and internal databases to build a unified picture of your customers.
 
+## What's a Source?
 
-## What is a source
+{% include content/whats-a-source.md %}
 
-Sources in Segment are created for each website you want to track. While not required to have a single Source for each server, site or app, **Segment recommendeds creating a Source for each unique source of data**.
-
-Sources belong to a workspace and the URL will look something like this:
-
-`https://segment.com/<my-workspace>/sources/<my-source-name>/`
-
-You can create new sources using the button in the workspace view. Each source you create will have a write key which is used to send data to that source. For example, to load [`analytics.js`, the Segment JavaScript library](https://segment.com/docs/connections/sources/catalog/libraries/website/analytics.js/) on your page, the snippet on the [Quickstart Guide](https://segment.com/docs/connections/sources/catalog/libraries/website/analytics.js/quickstart/) includes:
-
-```js
-analytics.load("YOUR_WRITE_KEY");
-```
-
-
-## What is a destination?
-
-Destinations are business tools or apps that you can connect via Segment with the flick of a switch. Some of our most popular destinations are Google Analytics, Mixpanel, KISSmetrics, Customer.io, Intercom, and KeenIO.
-
-All these tools run on the same data: who are your customers and what are they doing. However, each tool requires that data in slightly different formats. Without Segment, you have to write code to track all of this information, again and again, for each tool, on each page of your app or website.
-
-We eliminate this process by introducing an abstraction layer. You just send your data to us. We understand it, translate it, and send it along to any destination you toggle on in the Segment destinations catalog. Immediately, your user data will start flowing into those tools' dashboards. No extra code required!
-
-We support many categories of destinations, from advertising to marketing, email to customer support, CRM to user testing, and even data warehouses. You can view a complete list of our [destinations](https://segment.com/docs/connections/destinations/) or check out our [Catalog page](https://segment.com/catalog) for a searchable list broken down by category.
+## What's a Destination?
 
+{% include content/whats-a-destination.md %}
 
 ## What information can I see on Sources and Destinations pages?
 
@@ -58,22 +40,6 @@ You can then sort or filter each column to just the values you care about, by cl
 
 
 
+## What is a Warehouse?
 
-## What is a warehouse?
-
-A warehouse is a central repository of data that has been collected from one or more sources. This is what commonly comes to mind when thinking about a relational database – structured data that fits neatly into rows and columns.
-
-In Segment, a Warehouse is a special subset of destinations where we load data to them in bulk at a regular interval, inserting and updating events and objects while automatically adjusting their schema to fit the data you've sent to Segment.
-
-When selecting and building a data warehouse, there are three questions to consider:
-
-1.  What type of data will be collected?
-
-2.  How many data sources will there be?
-
-3.  How will the data be used?
-
-
-Relational databases are great when you know and predefine the information collected and how it will be linked. This is usually the type of database used in the world of user analytics. For instance, a users table might be populated with the columns "name", "email address", "plan name", etc.
-
-Examples of data warehouses include Amazon Redshift, Google BigQuery, MySQL, and Postgres.
+{% include content/whats-a-warehouse.md %}
@@ -2,7 +2,7 @@
 title: Getting Started with Segment
 ---
 
-## What is Segment?"
+## What is Segment?
 
 Segment is a single platform that collects, stores, and routes your user data to hundreds of tools with the flick of a switch.