From cb7550c8355bfdc43e4309a4830639db08fd7a41 Mon Sep 17 00:00:00 2001
From: Raviraj Bahirsheth <111955585+rbahirsheth@users.noreply.github.com>
Date: Thu, 13 Apr 2023 18:26:07 +0530
Subject: [PATCH] Breaking changes mentioned for v5.0.0

---
 docs/upgrade-guide/upgrade411-50.md | 37 ++++++++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/docs/upgrade-guide/upgrade411-50.md b/docs/upgrade-guide/upgrade411-50.md
index d4b399b10b..26256790d8 100644
--- a/docs/upgrade-guide/upgrade411-50.md
+++ b/docs/upgrade-guide/upgrade411-50.md
@@ -73,7 +73,42 @@ After starting the app, if everything is working fine, that's all and you don't
 
 2.  Clean your old distribution and dependencies by deleting `node_modules` and `package-lock.json`.
 
-3.  Reinstall your dependencies
+3.  This is a major release of the Alfresco Application Development Framework containing upgrade to Angular 14.
+    With the current upgrade of the Angular framework, the suggested stack has also being updated:
+
+    | Name | Version | 
+    | --- | --- | 
+    | Node | 14.15.0 |
+    | npm | 6.14.8 |
+    | Angular | 14 |
+    | Typescript | 4.6 |
+
+    For a complete list of changes, supported browsers and new feature please refer to the official documentation
+
+    | Angular version | link |
+    | --- | --- |
+    | v11 | [Changes & Deprecations](https://v11.angular.io/guide/updating-to-version-11)|
+    | v12 | [Changes & Deprecations](https://v12.angular.io/guide/updating-to-version-12)|
+    | v13 |  [Changes & Deprecations](https://v13.angular.io/guide/update-to-latest-version)|
+    | v14 | [Changes & Deprecations](https://angular.io/guide/update-to-latest-version) |
+
+    ## Upgrade
+
+    To migrate custom code and application to Angular 14, please refer to the [offcial documentation](https://angular.io/).
+
+    **Note:**: Consider the possibility of leveraging [ADF v5.0.0-angular.13.2](https://www.npmjs.com/package/@alfresco/adf-core/v/5.0.0-angular.13.2), a       version of ADF compatible with Angular 13 that is meant to be used as intermediate step towards ADF v5. with angular v14.
+    
+4.  A breaking change worth mentioning is related to style import. with ADF v5.0.0 an extra ```\lib``` is required.
+
+
+    **example**:
+
+    previous versions of ADF :  ```@import '~@alfresco/adf-core/prebuilt-themes/adf-blue-orange.css';```
+    
+    starting ADF 5.0.0 : ```@import '~@alfresco/adf-core/lib/prebuilt-themes/adf-blue-orange.css';```
+
+
+5.  Reinstall your dependencies
     ```sh
     npm install
     ```