From 0c7be3e61af041e460256fe6be8c945653222c4b Mon Sep 17 00:00:00 2001
From: Valerio Provaggi <95288179+vprovaggi@users.noreply.github.com>
Date: Mon, 12 Sep 2022 17:00:28 +0200
Subject: [PATCH] Release notes for ADF 5 (#7819)

* Release notes for A14

Added content to describe content, features and upgrade.

* minor format changes
---
 docs/release-notes/RelNote500.md | 35 ++++++++++++++++++++++++++++++--
 1 file changed, 33 insertions(+), 2 deletions(-)

diff --git a/docs/release-notes/RelNote500.md b/docs/release-notes/RelNote500.md
index cd625b3ee1..767024f2df 100644
--- a/docs/release-notes/RelNote500.md
+++ b/docs/release-notes/RelNote500.md
@@ -4,7 +4,7 @@ Title: Release notes v5.0.0
 
 # Alfresco Application Development Framework (ADF) version 5.0.0 Release Note
 
-This document provides information on the Alfresco Application Development Framework **v4.10.0**.
+This document provides information on the Alfresco Application Development Framework **v5.0.0**.
 
 You can find release artifacts on [GitHub](https://github.com/Alfresco/alfresco-ng2-components/releases/tag/5.0.0).
 
@@ -12,6 +12,7 @@ You can find release artifacts on [GitHub](https://github.com/Alfresco/alfresco-
 
 - [New Package Versions](#new-package-versions)
 - [Features](#features)
+- [Upgrade](#upgrade)
 - [Changelog](#changelog)
 - [See Also](#see-also)
 
@@ -29,7 +30,37 @@ You can find release artifacts on [GitHub](https://github.com/Alfresco/alfresco-
 
 ## Features
 
-This is a minor release of the Alfresco Application Development Framework containing bug fixes and enhancements.
+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. 
+
+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';```
 
 ## Changelog