Skip to content

Commit 24d04e7

Browse files
committed
edits to getting started
1 parent 8131c20 commit 24d04e7

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

src/getting-started/01-what-is-segment.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
2-
title: How Segment Works
2+
title: How Segment works
33
---
44

5-
In a nutshell, the Segment libraries ([Sources](/docs/connections/sources/catalog/)) generate messages about what's happening in your site or app, and send them to the Segment servers. Segment then translates the content of those messages into different formats for use by other tools (which Segment calls [Destinations](/docs/connections/destinations/)), and sends the translated messages to those tools. The Segment servers also archive a copy of the data, and can [send data to your storage systems](/docs/connections/storage/) (such as databases, warehouses, or bulk-storage buckets).
5+
In short, the Segment libraries (called [Sources](/docs/connections/sources/catalog/)) generate messages about activity in your site or app, and send them to the Segment servers. Segment then translates the content of those messages into different formats for use by other tools (called [Destinations](/docs/connections/destinations/)), and sends the translated messages to those tools. The Segment servers also archive a copy of the data, and can [send data to your storage systems](/docs/connections/storage/) (such as databases, warehouses, or bulk-storage buckets).
66

77

88
## Overview
@@ -46,14 +46,14 @@ When you collect data using device-based libraries, you can choose between these
4646
* **Cloud-mode** is where the library sends the data directly to the Segment servers which then translate and forward it.
4747
* **Device-mode** is where the library sends the data both directly to the Segment servers, and also to the servers for the destination tool. Device-mode sometimes requires some [additional set-up steps](/docs/connections/sources/mobile_guide/), but can unlock rich device data.
4848

49-
Although there are some tradeoffs between the two approaches, neither is better than the other, and Segment recommends that you implement a mix of both. In general, more direct interaction data is available using a device-based library, but server-based collection is more secure, reliable, and can't be blocked by ad blockers.
49+
Although there are some tradeoffs between the two approaches, neither is better than the other, and we recommends that you implement a mix of both. In general, more direct interaction data is available using a device-based library, but server-based collection is more secure, reliable, and can't be blocked by ad blockers.
5050

5151
<!-- Here's a handy flow chart to help with the client-side/server-side decision:
5252
5353
TODO: Image removed, didn't work with formatting. need a better version of this flowchart or else to just omit?-->
5454

5555

56-
## The Segment methods
56+
## Segment methods
5757

5858
The Segment libraries generate messages about what happens on your interface, translate those messages into different formats for use by destinations, and transmit the messages to those tools.
5959

@@ -71,7 +71,7 @@ Segment maintains a catalog of destinations where you can send your data.
7171

7272
<!--TODO: big list o' destinations image (programmatically update?) should go here-->
7373

74-
![""](images/dests_grid.png)
74+
![A catalog of destinations where you can send your data with Segment.](images/dests_grid.png)
7575

7676

7777
<div class="double">

0 commit comments

Comments
 (0)