Merge pull request magento#2164 from magento-devdocs/release-note-2-3-update-03172021

jfrontain · web-flow · commit 524b3947d6cc · 2021-03-18T16:25:34.000-05:00
Magento 2.3.6 release note backward incompatibility update March 18 2021
diff --git a/src/guides/v2.3/release-notes/commerce-2-3-6.md b/src/guides/v2.3/release-notes/commerce-2-3-6.md
@@ -46,6 +46,20 @@ CAPTCHA protection for these additional pages is disabled by default. It can be
 {:.bs-callout-info}
 Starting with the release of Magento Commerce 2.3.2, Magento will assign and publish indexed Common Vulnerabilities and Exposures (CVE) numbers with each security bug reported to us by external parties. This allows users of Magento Commerce to more easily identify unaddressed vulnerabilities in their deployment. You can learn more about CVE identifiers at [CVE](https://cve.mitre.org/).
 
+## Compatibility issues upgrading from Magento 2.3.5 to 2.3.6
+
+Merchants upgrading from Magento 2.3.5 to 2.3.6 and extension developers should be aware of these code changes:
+
+*  `\Magento\Sales\Model\Order\Pdf\Invoice` class constructor arguments have changed.
+
+   *  `\Magento\Framework\Locale\ResolverInterface` dependency has been replaced with  `\Magento\Store\Model\App\Emulation`.
+
+   *  You can no longer call a parent constructor from child classes with the same arguments.
+
+*  Protected property `\Magento\Sales\Model\Order\Pdf\Invoice::_localeResolver`  has been removed and cannot be used in child classes.
+
+*  If your module contains a class that extends `\Magento\Sales\Model\Order\Pdf\Invoice` and must support both Magento 2.3.5 and 2.3.6, see the recommended solution documented in this [comment](https://github.com/magento/magento2/issues/30684#issuecomment-722602562).
+
 ## Fixed issues
 
 We have fixed hundreds of issues in the Magento 2.3.6 core code.
diff --git a/src/guides/v2.3/release-notes/open-source-2-3-6.md b/src/guides/v2.3/release-notes/open-source-2-3-6.md
@@ -38,6 +38,19 @@ This release includes over 15 security fixes and platform security improvements.
 
 {:.bs-callout-info}
 Starting with the release of Magento Commerce 2.3.2, Magento will assign and publish indexed Common Vulnerabilities and Exposures (CVE) numbers with each security bug reported to us by external parties. This allows users of Magento Commerce to more easily identify unaddressed vulnerabilities in their deployment.
+## Compatibility issues upgrading from Magento 2.3.5 to 2.3.6
+
+Merchants upgrading from Magento 2.3.5 to 2.3.6 and extension developers should be aware of these code changes:
+
+*  `\Magento\Sales\Model\Order\Pdf\Invoice` class constructor arguments have changed.
+
+   *  `\Magento\Framework\Locale\ResolverInterface` dependency has been replaced with  `\Magento\Store\Model\App\Emulation`.
+
+   *  You can no longer call a parent constructor from child classes with the same arguments.
+
+*  Protected property `\Magento\Sales\Model\Order\Pdf\Invoice::_localeResolver`  has been removed and cannot be used in child classes.
+
+*  If your module contains a class that extends `\Magento\Sales\Model\Order\Pdf\Invoice` and must support both Magento 2.3.5 and 2.3.6, see the recommended solution documented in this [comment](https://github.com/magento/magento2/issues/30684#issuecomment-722602562).
 
 ## Fixed issues
 
