README.md in ibandit-1.9.0 vs README.md in ibandit-1.10.0

- old
+ new

@@ -2,19 +2,19 @@ ======= Ibandit is a Ruby library for manipulating and validating [IBANs](http://en.wikipedia.org/wiki/International_Bank_Account_Number). -The primary objective is to provide an interface that enables the storage and retrieval national banking details as a single value. This may be an IBAN, if a country fully and unambiguously supports it, or a combination of IBAN and/or pseudo-IBAN. +The primary objective is to provide an interface that enables the storage and retrieval of national banking details as a single value. This may be an IBAN, if a country fully and unambiguously supports it, or a combination of IBAN and/or pseudo-IBAN. Therefore, there are three distinct modes: 1. For countries that support any form of IBAN: construct and validate IBAN from national banking details 2. For countries that have unambiguous IBANs: deconstruct an IBAN into national banking details 3. For countries where either of the above is not possible: a pseudo-IBAN as a substitute for the above. -For storage, you should always try to use the `pseudo_iban`, falling back to `iban` if it not available. +For storage, you should always try to use the `pseudo_iban`, falling back to `iban` if it is not available. For example: - Sweden does support IBANs (**1.**) but the format is ambiguous due to variable length account numbers so they cannot be deconstructed (**2.**). For persistence, we therefore recommend using pseudo-IBANs (**3.**) because the national banking details can be recovered from them. - Australia does not support IBANs (**1.** & **2.**), therefore pseudo-IBANs (**3.**) can be created from national banking details for storage. To get back the national banking details, you can pass the pseudo-IBAN to Ibandit and it will parse out the national banking details again for use. @@ -127,18 +127,18 @@ end Ibandit.modulus_checker = ModulusChecker ``` -All three the `valid_bank_code?`, `valid_branch_code?` and `valid_account_number?` methods will receive an `IBAN` object. +All three of the `valid_bank_code?`, `valid_branch_code?` and `valid_account_number?` methods will receive an `IBAN` object. `valid_bank_code?` and `valid_branch_code?` should return true unless it is known that the bank/branch code in this IBAN are invalid in the country specified. `valid_account_number?` should return true unless it is known that the account number in this IBAN cannot be valid due to local modulus checking rules. ### Deconstructing an IBAN into national banking details SWIFT define the following components for IBANs, and publish details of how each -county combines them: +country combines them: `country_code` : The [ISO 3166-1](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) country code prefix `check_digits`