docs: add migration note for new multi-channel format (#457)

intershop · Nov 16, 2020 · ab733d1 · ab733d1
1 parent 0023025
commit ab733d1
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 0 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -61,6 +61,7 @@ kb_everyone
 
 - Setting certain cookies can no longer be dependent on the `cookieLawSeen$` state but needs to be checked with `cookieService.cookieConsentFor()`.
 - The login/logout handling is abstracted as identity provider service.
+- The format for setting up Multi-Site support with nginx has changed.
 
 ## [0.24.0](https://github.com/intershop/intershop-pwa/releases/tag/0.24.0) (2020-09-30)
 

diff --git a/docs/guides/migrations.md b/docs/guides/migrations.md
@@ -18,6 +18,10 @@ A basic configuration is already provided.
 The cookie consent configuration and usage is documented in our [Cookie Consent Guide](./cookie-consent.md).
 With this change it is necessary to adapt all uses of the `cookiesService.cookieLawSeen$` observable with the new synchronous method - `cookiesService.cookieConsentFor('tracking')` - provided to check for the required cookie consent.
 
+We reworked the configuration format for setting up multiple channels in the nginx to enable context-path support.
+Multiple `PWA_X_` environment properties are no longer supported, instead a structured configuration has to be supplied.
+For more information see [Nginx documentation](./nginx-startup.md).
+
 ## 0.23 to 0.24
 
 We introduced a [localization file clean up script](../concepts/localization.md#localization-file-clean-up-process) that removes all unused localization keys from the localization files and sorts the remaining keys.