Merge pull request #57 from froschdesign/hotfix/docs/servicemanager

Adds missing installation requirements for translator and updates descriptions for suggested packages in Composer config file

composer.json

@@ -45,12 +45,12 @@
         "phpspec/prophecy": "<1.9.0"
     },
     "suggest": {
-        "laminas/laminas-cache": "Laminas\\Cache component",
-        "laminas/laminas-config": "Laminas\\Config component",
+        "laminas/laminas-cache": "You should install this package to cache the translations",
+        "laminas/laminas-config": "You should install this package to use the INI translation format",
         "laminas/laminas-eventmanager": "You should install this package to use the events in the translator",
         "laminas/laminas-filter": "You should install this package to use the provided filters",
-        "laminas/laminas-i18n-resources": "Translation resources",
-        "laminas/laminas-servicemanager": "Laminas\\ServiceManager component",
+        "laminas/laminas-i18n-resources": "This package provides validator and captcha translations",
+        "laminas/laminas-servicemanager": "You should install this package to use the translator",
         "laminas/laminas-validator": "You should install this package to use the provided validators",
         "laminas/laminas-view": "You should install this package to use the provided view helpers"
     },

docs/book/translation.md

@@ -9,6 +9,15 @@ The translator itself is initialized without any parameters, as any
 configuration to it is optional. A translator without any translations will do
 nothing but return all messages verbatim.
 
+<!-- markdownlint-disable-next-line MD001 -->
+> ### Installation Requirements
+>
+> The translation support of laminas-i18n depends on the [laminas-servicemanager](https://docs.laminas.dev/laminas-servicemanager/) component, so be sure to have it installed before getting started:
+>
+> ```bash
+> $ composer require laminas/laminas-servicemanager
+> ```
+
 ## Adding translations
 
 Two options exist for adding translations to the translator:
@@ -74,6 +83,14 @@ Additionally, you can use custom formats by implementing one or more of
 `Laminas\I18n\Translator\Loader\RemoteLoaderInterface`, and registering your loader
 with the `Translator` instance's composed plugin manager.
 
+> ### Installation Requirements
+>
+> The support of the INI translation format depends on the [laminas-config](https://docs.laminas.dev/laminas-config/) component, so be sure to have it installed before getting started:
+>
+> ```bash
+> $ composer require laminas/laminas-config
+> ```
+
 ## Setting a locale
 
 By default, the translator will get the locale to use from ext/intl's `Locale`