Merge branch 'docs/21' into develop

Forward port #21

docs/book/migration/migration-to-v2.4.md

@@ -0,0 +1,31 @@
+# Migration from Versions prior to 2.4
+
+## General
+
+Version 2.4 adds support for PHP 7.
+
+## Validators
+
+### IsFloat
+
+In PHP 7, `float` is a reserved keyword, which required renaming the
+`Laminas\I18n\Validator\Float` validator. If you were using the
+`Laminas\I18n\Validator\Float` validator directly previously, you will now
+receive an `E_USER_DEPRECATED` notice on instantiation. Please update your code
+to refer to the `Laminas\I18n\Validator\IsFloat` class instead.
+
+Users pulling their `Laminas\I18n\Validator\Float` validator instance from the
+validator plugin manager receive an `Laminas\I18n\Validator\IsFloat` instance
+instead starting in 2.4.0.
+
+### IsInt
+
+In PHP 7, `int` is a reserved keyword, which required renaming the 
+`Laminas\I18n\Validator\Int` validator. If you were using the
+`Laminas\I18n\Validator\Int` validator directly previously, you will now
+receive an `E_USER_DEPRECATED` notice on instantiation. Please update your code
+to refer to the `Laminas\I18n\Validator\IsInt` class instead.
+
+Users pulling their `Laminas\I18n\Validator\Int` validator instance from the
+validator plugin manager receive an `Laminas\I18n\Validator\IsInt` instance
+instead starting in 2.4.0.

mkdocs.yml

@@ -14,6 +14,8 @@ nav:
             - IsInt: validators/is-int.md
             - PhoneNumber: validators/phone-number.md
             - PostCode: validators/post-code.md
+    - Migration:
+        - 'Migration from Versions prior to 2.4': migration/migration-to-v2.4.md
 site_name: laminas-i18n
 site_description: 'Provide translations for your application, and filter and validate internationalized values.'
 repo_url: 'https://github.com/laminas/laminas-i18n'