DOC-642 format kilobytes

Author: rchinn1

src/_includes/content/tracking-api-limit.md

@@ -1,4 +1,4 @@
-<div class="premonition warning"><div class="fa fa-exclamation-circle"></div><div class="content"><p class="header">HTTP Tracking API limits</p><p>Segment's HTTP Tracking API accepts batch requests up to <strong>500kb</strong>. To avoid errors in event creation, ensure that individual event payload sizes remain below <strong>32kb</strong>.</p>
+<div class="premonition warning"><div class="fa fa-exclamation-circle"></div><div class="content"><p class="header">HTTP Tracking API limits</p><p>Segment's HTTP Tracking API accepts batch requests up to <strong>500KB</strong>. To avoid errors in event creation, ensure that individual event payload sizes remain below <strong>32KB</strong>.</p>
 
 
-</div></div>
+</div></div>

src/connections/destinations/catalog/preact/index.md

@@ -31,7 +31,7 @@ All you have to do is add a "!" as the first character in the event name and Pre
 Here's a JavaScript example:
 ```javascript
 analytics.track('!Image upload error', {
-    File size: '890kb',
+    File size: '890KB',
     File extension: '.JPG',
     Message: 'File size too large'
     });

src/connections/sources/catalog/libraries/mobile/android/android-faqs.md

@@ -25,7 +25,7 @@ Yes! You can use the Segment library with Maven, or any other custom build syste
 
 ## How big is the Segment SDK?
 
-The core Segment SDK is extremely lightweight! It contains just under 1k methods, the JAR weighs in at 123kb and the dex size is 113kb.
+The core Segment SDK is extremely lightweight. It contains just under 1k methods, the JAR weighs in at 123KB and the dex size is 113KB.
 
 ## How can I swap out debugging and production keys?
 

src/connections/sources/catalog/libraries/mobile/ios/ios-faqs.md

@@ -5,22 +5,22 @@ strat: ios
 
 ## How big is the Segment SDK?
 
-The core Segment SDK is extremely lightweight. It weighs in at about 212kb.
+The core Segment SDK is extremely lightweight. It weighs in at about 212KB.
 
 
 ## Can I install the SDK manually using a dynamic framework?
 
-Segment **highly recommends** using Swift Package Manager or Cocoapods. We cannot guarantee support if you do not use a dependency manager.
+Segment **highly recommends** using Swift Package Manager or Cocoapods. Segment can't guarantee support if you do not use a dependency manager.
 
-However, if you cannot use Swift Package Manager or Cocoapods, you can manually install our dynamic framework allowing you to send data to Segment and on to enabled cloud-mode destinations. We do not support sending data to bundled, device-mode integrations outside of Cocoapods.
+However, if you cannot use Swift Package Manager or Cocoapods, you can manually install Segment's dynamic framework allowing you to send data to Segment and on to enabled cloud-mode destinations. Segment doesn't support sending data to bundled, device-mode integrations outside of Cocoapods.
 
 To install manually:
 
-1. Download the [latest built SDK](https://github.com/segmentio/analytics-ios/releases/), and unzip the zip file
+1. Download the [latest built SDK](https://github.com/segmentio/analytics-ios/releases/){:target="blank"}, and unzip the zip file
 2. Drag the unzipped `Segment.framework` folder into your XCode project
 3. In the **General Tab** for your project, search for `Embedded Binaries` and add the `Segment.framework`
 
-![](images/embeddedbinaries.png)
+![Segment framework example](images/embeddedbinaries.png)
 
 
 Once you install the framework, import the header file and install as described in [Install the SDK](https://segment.com/docs/connections/sources/catalog/libraries/mobile/ios#install-the-sdk).
@@ -58,7 +58,7 @@ CLLocation *location = locationManager.location;
 
 ## How do I use push notifications?
 
-For services that send push notifications, you must first [create a Push SSL certificate](https://developer.apple.com/library/content/documentation/IDEs/Conceptual/AppDistributionGuide/AddingCapabilities/AddingCapabilities.html). Then configure your application delegate similarly to the example code below, replacing `YOUR_WRITE_KEY` with your own Segment source write key.  Detailed examples of how to complete the process can be found in [Apple's documentation on the subject](https://developer.apple.com/documentation/usernotifications/handling_notifications_and_notification-related_actions).
+For services that send push notifications, you must first [create a Push SSL certificate](https://developer.apple.com/library/content/documentation/IDEs/Conceptual/AppDistributionGuide/AddingCapabilities/AddingCapabilities.html){:target="blank"}. Then configure your application delegate similarly to the example code below, replacing `YOUR_WRITE_KEY` with your own Segment source write key.  Detailed examples of how to complete the process can be found in [Apple's documentation on the subject](https://developer.apple.com/documentation/usernotifications/handling_notifications_and_notification-related_actions){:target="blank"}.
 
 
 {% codeexample %}
@@ -71,7 +71,7 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau
     configuration.launchOptions = launchOptions
     Analytics.setup(with: configuration)
 
-    // See the Apple linked above for detailed setup information, as it will vary 
+    // See the Apple linked above for detailed setup information, as it will vary
     // based on which versions of iOS are supported and what language is being used.
     ...
 
@@ -90,7 +90,7 @@ func application(_ application: UIApplication, didFinishLaunchingWithOptions lau
     configuration.launchOptions = launchOptions;
     [SEGAnalytics setupWithConfiguration:configuration];
 
-    // See the Apple documentation linked above for detailed setup information, as it will vary 
+    // See the Apple documentation linked above for detailed setup information, as it will vary
     // based on which versions of iOS are supported and what language is being used.
     ...
 
@@ -161,17 +161,17 @@ Analytics.shared().identify(nil, traits: ["email": "[email protected]", "gende
 
 ## Do you support iOS 10.x?
 
-Analytics-iOS supports iOS 11.0+. If you need support for older operating systems you can fork [the Segment iOS repo on GitHub](https://github.com/segmentio/analytics-ios/) and [build the framework](https://github.com/segmentio/analytics-ios/wiki/Building-the-framework) with support for your version of iOS.
+Analytics-iOS supports iOS 11.0+. If you need support for older operating systems you can fork [the Segment iOS repo on GitHub](https://github.com/segmentio/analytics-ios/){:target="blank"} and [build the framework](https://github.com/segmentio/analytics-ios/wiki/Building-the-framework){:target="blank"} with support for your version of iOS.
 
 
 ## Is the Segment SDK compatible with Swift?
 
-Yes, Swift's compatibility with Objective-C lets you create a source that contains files written in either language. To use the Segment Analytics-iOS SDK from a Swift source, [follow these instructions from Apple](https://developer.apple.com/library/ios/documentation/Swift/Conceptual/BuildingCocoaApps/MixandMatch.html).
+Yes, Swift's compatibility with Objective-C lets you create a source that contains files written in either language. To use the Segment Analytics-iOS SDK from a Swift source, [follow these instructions from Apple](https://developer.apple.com/library/ios/documentation/Swift/Conceptual/BuildingCocoaApps/MixandMatch.html){:target="blank"}.
 
 
 ## Can I help develop a destination?
 
-Yes, the Segment [Analytics-iOS SDK is open-source](https://github.com/segmentio/analytics-ios). If you'd like to contribute, fix a bug, or add a destination please [see the contributing guide](https://github.com/segmentio/analytics-ios/blob/master/CONTRIBUTING.md).
+Yes, the Segment [Analytics-iOS SDK is open-source](https://github.com/segmentio/analytics-ios){:target="blank"}. If you'd like to contribute, fix a bug, or add a destination please [see the contributing guide](https://github.com/segmentio/analytics-ios/blob/master/CONTRIBUTING.md){:target="blank"}.
 
 
 ## How do I know when a destination is initialized?
@@ -249,4 +249,4 @@ Some destinations, especially mobile attribution tools (for example, [Kochava](h
 
 ## tvOS / macOS / Catalyst Support
 
-As of [Version 4.1.0](https://github.com/segmentio/analytics-ios/releases/tag/4.1.0), Analytics-iOS now supports tvOS, macOS and Catalyst as well. You can follow the [quickstart documentation](/docs/connections/sources/catalog/libraries/mobile/ios/quickstart/) to set it up!
+As of [Version 4.1.0](https://github.com/segmentio/analytics-ios/releases/tag/4.1.0){:target="blank"}, Analytics-iOS now supports tvOS, macOS, and Catalyst as well. You can follow the [quickstart documentation](/docs/connections/sources/catalog/libraries/mobile/ios/quickstart/) to set it up.

src/connections/sources/catalog/libraries/mobile/react-native/react-faqs.md

@@ -7,13 +7,13 @@ strat: react-native
 
 ### Can I help develop a destination?
 
-Yep! Our SDK is [open-source](https://github.com/segmentio/analytics-react-native). If you'd like to contribute, fix a bug, or add a destination - here's [documentation on how to do so](https://github.com/segmentio/analytics-react-native/blob/master/CONTRIBUTING.md). to add a destination, make sure you contact our [partners team](https://github.com/segmentio/analytics-react-native/blob/master/CONTRIBUTING.md) first.
+Yes, Segment's SDK is [open-source](https://github.com/segmentio/analytics-react-native){:target="blank"}. If you'd like to contribute, fix a bug, or add a destination - here's [documentation on how to do so](https://github.com/segmentio/analytics-react-native/blob/master/CONTRIBUTING.md){:target="blank"}. To add a destination, make sure you contact Segment's [partners team](https://github.com/segmentio/analytics-react-native/blob/master/CONTRIBUTING.md){:target="blank"} first.
 
 
 
 ### How big is the Segment SDK?
 
-The core Segment SDK is extremely lightweight! On iOS it weighs in at about 212kb. On Android it contains just under 1k methods, the JAR weighs in at 123kb and the dex size is 113kb.
+The core Segment SDK is extremely lightweight. On iOS it weighs in at about 212KB. On Android it contains just under 1k methods, the JAR weighs in at 123KB and the dex size is 113KB.
 
 ### Can I also use the native Analytics API?
 
@@ -41,4 +41,3 @@ These flags are used both to in code to [prevent data from being sent to specifi
 ### Why upgrade to React Native 2.0?
 
 React Native 2.0 is a major version upgrade to the existing React Native library that includes several performance upgrades. The older version of the Analytics React Native library was built as a JavaScript wrapper for Segment's native analytics-android and analytics-ios libraries, which made feature development and bug fixes unsustainable, as they often required changes to the underlying libraries. The new Analytics React Native library executes less lines of code in a quicker manner with smaller algorithms. In addition, it no longer relies on analytics-ios or analytics-android. It has been rebuilt to be a standalone JavaScript library which drastically reduces the amount of dependencies required for React Native customers. Overall, it improves Analytics performance, provides a better developer experience, and uses less CPU, battery and memory.
-

src/connections/sources/catalog/libraries/server/object-api/index.md

@@ -2,11 +2,13 @@
 title: Objects API
 ---
 
-NOTE: The Objects API is in beta, and so features and names may change without notice as we continue to build.
+> info ""
+> The Objects API is in beta, and so features and names may change without notice as Segment continues to build.
 
-The Segment Objects API allows you to send business objects relevant to your business right to Redshift and other Segment supported data warehouses.
+Use the Segment Objects API to send business objects relevant to your business right to Redshift and other Segment supported data warehouses.
 
-NOTE: We haven't yet added support for set to our core `analytics-<language>` libraries so you'll need to use our HTTP API directly or our independent Go(lang) client for now.
+> warning ""
+> Segment hasn't added support for the core `analytics-<language>` libraries so you'll need to use the Segment HTTP API directly or the independent Go(lang) client for now.
 
 ### Authentication
 
@@ -15,13 +17,13 @@ Authentication uses HTTP Basic Auth, which involves a 'username:password' that i
 
 In practice that means taking a Segment source **Write Key**,`'abc123'`, as the username, adding a colon, and then the password field is left empty. After base64 encoding `'abc123:'` becomes `'YWJjMTIzOg=='`; and this is passed in the authorization header like so: `'Authorization: Basic YWJjMTIzOg=='`.
 
-### Source Type
+### Source type
 
-set up an `HTTP API` source type in Segment. You will use this source write key for authenticating with the Objects API.
+Set up an `HTTP API` source type in Segment. You will use this source write key for authenticating with the Objects API.
 
-### Content-Type
+### Content-type
 
-In order to send data to our HTTP API, the content-type header must be set to `'application/json'`.
+In order to send data to Segment's HTTP API, the content-type header must be set to `'application/json'`.
 
 ## Errors
 
@@ -31,13 +33,15 @@ The Objects API returns a 200 response in most cases, similar to the Tracking AP
 
 It's highly recommended that you batch your objects where you can. This will allow you to make significantly fewer requests to Segment. To batch your requests, simply pass in more than one object into the objects array.
 
-Note: the max batch size is 10 objects per request.
+> info ""
+> The max batch size is 10 objects per request.
 
-## Synchronous Mode
+## Synchronous mode
 
 The Objects API is asynchronous by default. This means that if object updates are processed close together, they can be processed out of order. To change this default behavior, you can set the header `Synchronous: true` to ensure synchronous delivery of objects downstream.
 
-Note: The average response time increases with the synchronous objects API header set, which can impact performance speed.
+> info ""
+> The average response time increases with the synchronous objects API header set, which can impact performance speed.
 
 ## Regional configuration
 
@@ -49,7 +53,7 @@ For Business plans with access to [Regional Segment](/docs/guides/regional-segme
 
 ### snake_case properties
 
-It is recommended that you use snake case when naming any object properties.
+Segment recommends that you use snake case when naming any object properties.
 
 ```json
 {
@@ -61,7 +65,7 @@ It is recommended that you use snake case when naming any object properties.
 }
 ```
 
-### Plural Collection Names
+### Plural collection names
 
 You should use plural collection names wherever possible. The collection name should describe the group of one or many objects within the collection.
 
@@ -71,9 +75,9 @@ You should use plural collection names wherever possible. The collection name sh
 "collection": "reviews"
 ```
 
-## De-dupe & merge
+## De-dupe and merge
 
-Objects with the same object ID will get de-duped and properties will get merged. By sending in partial objects with the same object ID, we will merge the properties and you can query the latest data in your data warehouse.
+Segment de-dupes objects with the same ID and merges properties. By sending in partial objects with the same object ID, Segment merges the properties and you can query the latest data in your data warehouse.
 
 For example, if you make the following requests with the following payloads:
 
@@ -152,52 +156,15 @@ POST https://objects.segment.com/v1/set
 
 This call sends a collection of "rooms". "rooms" becomes the table name in your data warehouse, and each individual object in the array becomes a row in that table.
 
-<table>
-  <tr>
-    <td>`collection` - Required</td>
-    <td>String</td>
-    <td>
-    	A string that represents the name of the collection. The collection name will become the table name in your data warehouse.
-
-    	Collection must consist of lowercase letters and underscores and maximum of 100 characters. Can not begin or end with an underscore.
-
-    </td>
-  </tr>
-  <tr>
-    <td>`objects`</td>
-    <td>Array</td>
-    <td>
-  A required array of objects describing the objects and properties being set.
-
-  Must consist of at least one JSON object and a maximum of 10.
-
-    </td>
-  </tr>
-</table>
+|-------------------------|--------|-------------------------------------------------------------------------------------------|
+| `collection` *Required* | String | A string that represents the name of the collection. The collection name will become the table name in your data warehouse. Collection must consist of lowercase letters and underscores and maximum of 100 characters. Can not begin or end with an underscore. |
+| `objects`               | Array  | A required array of objects describing the objects and properties being set. Must consist of at least one JSON object and a maximum of 10.  |
 
 Each object inside of the objects array must consist of the following parameters:
 
-<table>
-  <tr>
-    <td>`id` - Required</td>
-    <td>String</td>
-    <td>
-    The unique ID representing the object in the third party system.
-    Maximum of 100 characters.
-    </td>
-  </tr>
-  <tr>
-    <td>`Properties` - Required</td>
-    <td>Object</td>
-    <td>
-The object properties that represent the object. Example:
-
-Each value could be a string (ISO dates are parsed and recognised as `isodate` type), an integer, or a float (JSON types).
-
-Values cannot be lists or objects. Each value must be less 32kb in size.
-    </td>
-  </tr>
-</table>
+|-------------------------|--------|-------------------------------------------------------------------------------------------|
+| `id` *Required*         | String | The unique ID representing the object in the third party system. Maximum of 100 characters. |
+| `Properties` *Required* | Object | The object properties that represent the object. Example: Each value could be a string (ISO dates are parsed and recognized as `isodate` type), an integer, or a float (JSON types). Values cannot be lists or objects. Each value must be less than 32KB in size. |
 
 ## Objects-go library
 
@@ -228,7 +195,7 @@ Client.Set(*objects.Object{
 Client.Close()
 ```
 
-View the Objects-go library on GitHub [here](https://github.com/segmentio/objects-go).
+View the Objects-go library on GitHub [here](https://github.com/segmentio/objects-go){:target="_blank"}.
 
 Here is a `curl` example of how to get started:
 
@@ -247,7 +214,7 @@ No; you should continue use `analytics.identify` to identify your customers. We'
 
 ### Can you just pull data automatically from my database?
 
-If you would like this feature, [contact us](https://segment.com/help/contact/) and let us know.
+[Contact Segment](https://segment.com/help/contact/){:target="_blank"} if you would like this feature.
 
 ### How do you recommend we load object data into Segment?