README.md in sanitized_msisdns-0.0.2 vs README.md in sanitized_msisdns-0.0.3

@@ -1,32 +1,64 @@
-A small gem to sanitize MSISDNS as per mobile Number format. This is specially useful for building apis for Android or Iphone apps where the MSISDN is stored in different formats. Currently only indian numbers are supported. 
+Sanitize MSISDNS as per mobile number format. This is specially useful for formating Android mobile numbers which are stored in different formats. Currently only Indian MSISDNs are supported.
+
+##Usage
+
+    gem install sanitize_msisdns
+
+    require 'msisdn_sanitizer'
+
+    MSISDN::Sanitizer.sanitize('00919876543210')
+     => ["[phone]"]
+
+    MSISDN::Sanitizer.sanitize('0987-6543210')
+     => ["[phone]"]
+
+    MSISDN::Sanitizer.sanitize(['00919876543210', '9037 123 456', '04972123465'])
+     => ["[phone]", "[phone]"]
+
+    MSISDN::Sanitizer.sanitize(9876543210)
+     => ["[phone]"]
+
+You could also specify options, format & country_code ( Right now the only supported country code is ':in')
+The defaults are
+{
+    :country_code => :in,
+    :format => 'international'
+}
+
+    MSISDN::Sanitizer.sanitize(['00919876543210', '9037 123 456', '04972123465'], format: 'local')
+     => ["9876543210", "9037123456"]
+
+
+
+