Updates

README.md

@@ -1,56 +1,73 @@
-<img src="images/Iterable-Logo.svg">
+![Iterable logo](./images/Iterable-Logo.png "Iterable Logo")
 
 [![License](https://img.shields.io/cocoapods/l/Iterable-iOS-SDK.svg?style=flat)](https://opensource.org/licenses/MIT)
 [![Build Status](https://travis-ci.com/Iterable/swift-sdk.svg?branch=master)](https://travis-ci.com/Iterable/swift-sdk)
 [![pod](https://badge.fury.io/co/Iterable-iOS-SDK.svg)](https://cocoapods.org/pods/Iterable-iOS-SDK)
 [![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)
 
-# Iterable iOS SDK
+# Iterable's iOS SDK
 
-Iterable is a complete cross-channel customer engagement platform. Use it to message your customers across various channels (email, SMS, push, in-app messages, and web push notification) and grow your customer base, their engagement, and their lifetime value.
+[Iterable](https://www.iterable.com) is a growth marketing platform that helps
+you to create better experiences for—and deeper relationships with—your
+customers. Use it to send customized email, SMS, push notification, in-app
+message, and web push notifications to your customers.
 
-Iterable lets you send the right message, to the right device, at the right time.
+This SDK helps you integrate your iOS apps with Iterable. It supports iOS 9.0+.
 
-- [Iterable User Handbook](https://support.iterable.com/hc/articles/217389766)
-- [Mobile Engineer Guide](https://support.iterable.com/hc/articles/115000300426)
+## Installation
+
+For installation instructions, read [Iterable's iOS SDK](https://support.iterable.com/hc/articles/360035018152).
 
 ## Features
 
-- [SDK Initialization](https://support.iterable.com/hc/articles/360035018152)
-- [User Identity](https://support.iterable.com/hc/articles/360035402531)
+To learn more about various SDK features, read:
+
+- [Identifying the User](https://support.iterable.com/hc/articles/360035402531)
+- [Updating User Profiles](https://support.iterable.com/hc/articles/360035402611)
 - [Tracking Events](https://support.iterable.com/hc/articles/360035395671)
-- [Push Notifications](https://support.iterable.com/hc/articles/115000315806)
-- [Deep Linking](https://support.iterable.com/hc/articles/360035453971)
-- [Universal Links](https://support.iterable.com/hc/articles/360035496511)
-- [In-App Messages](https://support.iterable.com/hc/articles/360035536791)
-- [Mobile Inbox](https://support.iterable.com/hc/articles/360039137271)
+- [Setting up iOS Push Notifications](https://support.iterable.com/hc/articles/115000315806)
+- [Advanced iOS Push Notifications](https://support.iterable.com/hc/articles/360035451931)
+- [In-App Messages on iOS](https://support.iterable.com/hc/articles/360035536791)
+- [Setting up Mobile Inbox on iOS](https://support.iterable.com/hc/articles/360039137271)
+- [Customizing Mobile Inbox on iOS](https://support.iterable.com/hc/articles/360039091471)
+- [iOS Universal Links](https://support.iterable.com/hc/articles/360035496511)
+- [Deep Links in Push Notifications](https://support.iterable.com/hc/articles/360035453971)
+- [Deferred Deep Linking](https://support.iterable.com/hc/articles/360035165872)
+
+## Sample projects
 
-## Sample Projects
+For sample code, take a look at the following projects:
 
-- [Swift sample project](https://github.com/Iterable/swift-sdk/blob/master/sample-apps/swift-sample-app)
-- [Objective-C sample project](https://github.com/Iterable/swift-sdk/blob/master/sample-apps/objc-sample-app)
+- [Swift](https://github.com/Iterable/swift-sdk/blob/master/sample-apps/swift-sample-app)
+- [Objective-C](https://github.com/Iterable/swift-sdk/blob/master/sample-apps/objc-sample-app)
 - [Inbox Customization](https://github.com/Iterable/swift-sdk/tree/master/sample-apps/inbox-customization)
 
-## Version Support
+## Release notes, support, and troubleshooting
 
-- The Iterable iOS SDK supports iOS 9.0 and higher.
-- [iOS SDK Release Notes](https://support.iterable.com/hc/en-us/articles/360027798391)
-- [Mobile SDK Support Policy](https://support.iterable.com/hc/articles/360027798391#mobile-sdk-support-policy)
+For release notes, read:
 
-## Questions?
+- [iOS SDK Release Notes](https://support.iterable.com/hc/articles/360027798391) (major releases)
+- [Releases page](https://github.com/Iterable/swift-sdk/releases) on GitHub (minor releases)
 
-- [Mobile Developer Guides](https://support.iterable.com/hc/categories/360002288712)
-- [Mobile Support FAQ](https://support.iterable.com/hc/articles/360035624191)
-- [Mobile SDK Troubleshooting](https://support.iterable.com/hc/articles/360035392251)
+For information about Iterable's iOS SDK support policies, take a look at:
 
-## License
+- Iterable's [Mobile SDK Support Policy](https://support.iterable.com/hc/articles/360027798391#mobile-sdk-support-policy)
+- Iterable's [iOS SDK Deprecation and End-of-Life Schedule](https://support.iterable.com/hc/articles/360027798391#ios-sdk-deprecation-and-end-of-life-schedule)
 
-The MIT License
+For troubleshooting help, read:
 
-See [LICENSE](https://github.com/Iterable/swift-sdk/blob/master/LICENSE?raw=true)
+- [Testing and Troubleshooting Iterable's Mobile SDKs](https://support.iterable.com/hc/articles/360035392251)
+- [Frequently Asked Questions](https://support.iterable.com/hc/articles/360035624191) 
+  for mobile developers integrating with Iterable
 
-## Want to contribute?
+Please contact your customer success manager with any questions.
 
-This library is open source, and we will look at issue reports and pull requests!
+## License
+
+This SDK is released under the MIT License. See [LICENSE](https://github.com/Iterable/swift-sdk/blob/master/LICENSE?raw=true)
+for more information.
+
+## Want to contribute?
 
+This library is open source, and we will look at issue reports and pull requests.
 See [CONTRIBUTING](CONTRIBUTING.md) for more information.