Update README

Author: mattt

README.md

@@ -1,68 +1,87 @@
 # InflectorKit
 ![CI][ci badge]
 
-**Efficiently Singularize and Pluralize Strings**
-
-InflectorKit ports the string inflection functionality of [Rails ActiveSupport](https://github.com/rails/rails/blob/master/activesupport/lib/active_support/inflector/inflections.rb) to Foundation.
+InflectorKit is a port of the string inflection functionality from
+[Rails ActiveSupport](https://github.com/rails/rails/blob/master/activesupport/lib/active_support/inflector/inflections.rb) for Swift and Objective-C.
 
 > InflectorKit joins [FormatterKit](https://github.com/mattt/FormatterKit) & [TransformerKit](https://github.com/mattt/TransformerKit) in providing well-designed APIs for manipulating user-facing content.
 
 ## Usage
 
-```objective-c
-#import "NSString+InflectorKit.h"
-
-for (NSString *singular in @[@"person", @"tomato", @"matrix", @"octopus", @"fish"]) {
-  NSLog(@"%@: %@", singular, [singular pluralizedString]);
-}
-```
+### Swift
 
 ```swift
 import InflectorKit
 
 for singular in ["person", "tomato", "matrix", "octopus", "fish"] {
-    print(singular.pluralized)
+    print("\(singular) → \(singular.pluralized)")
 }
-```
+/*
+Prints:
+person → people
+tomato → tomatoes
+matrix → matrices
+octopus → octopi
+fish → fish
+*/
+
+// You can also add pluralization rules,
+// including irregular and uncountable words:
 
-    person: people
-    tomato: tomatoes
-    matrix: matrices
-    octopus: octopi
-    fish: fish
+let inflector = StringInflector.default
+inflector.addPluralRule(#"^i(Pod|Pad)( Mini)?$"#, replacement: #"i$1s$2"#)
+inflector.addIrregular(singular: "lol", plural: "lolz")
+inflector.addUncountable("Herokai")
+
+for singular in ["iPad Mini", "lol", "Herokai"] {
+    print("\(singular) → \(singular.pluralized)")
+}
+/*
+Prints:
+iPad Mini → iPads Mini
+lol → lolz
+Herokai → Herokai
+*/
+```
 
-You can also add pluralization rules, including irregular and uncountable words:
+### Objective-C
 
 ```objective-c
-#import "TTTStringInflector.h"
+#import "NSString+InflectorKit.h"
+
+for (NSString *singular in @[@"person", @"tomato", @"matrix", @"octopus", @"fish"]) {
+  NSLog(@"%@ → %@", singular, [singular pluralizedString]);
+}
+
+/*
+Prints:
+person → people
+tomato → tomatoes
+matrix → matrices
+octopus → octopi
+fish → fish
+*/
+
+// You can also add pluralization rules,
+// including irregular and uncountable words:
 
 TTTStringInflector *inflector = [TTTStringInflector defaultInflector];
 [inflector addPluralRule:@"^i(Pod|Pad)( Mini)?$" withReplacement:@"i$1s$2"];
 [inflector addIrregularWithSingular:@"lol" plural:@"lolz"];
 [inflector addUncountable:@"Herokai"];
 
 for (NSString *singular in @[@"iPad Mini", @"lol", @"Herokai"]) {
-  NSLog(@"%@: %@", singular, [singular pluralizedString]);
+  NSLog(@"%@ → %@", singular, [singular pluralizedString]);
 }
-```
-
-```swift
-import InflectorKit
 
-let inflector = StringInflector.default
-inflector.addPluralRule(#"^i(Pod|Pad)( Mini)?$"#, replacement: #"i$1s$2"#)
-inflector.addIrregular(singular: "lol", plural: "lolz")
-inflector.addUncountable("Herokai")
-
-for singular in ["iPad Mini", "lol", "Herokai"] {
-    print(singular.pluralized)
-}
+/*
+Prints:
+iPad Mini → iPads Mini
+lol → lolz
+Herokai → Herokai
+*/
 ```
 
-    iPad Mini: iPads Mini
-    lol: lolz
-    Herokai: Herokai
-
 ## License
 
 MIT