Merge pull request #1826 from mia-platform/rn_v13.5.0

rn_v13.5.0

Author: jacoposte

docs/development_suite/set-up-infrastructure/img/compare-snapshots.png

@@ -4,7 +4,8 @@ title: Manage Revisions and Versions
 sidebar_label: Manage Revisions and Versions
 ---
 
-In Projects adopting the Enhanced Workflow, `Revisions` and `Versions` replace the concept of `Branches` and `Tags`. The Console will not rely on the typical Git-based instruments anymore and will instead adopt a **new configuration management system**.
+In Projects adopting the Enhanced Workflow, `Revisions` and `Versions` replace the concept of `Branches` and `Tags`.
+The Console will not rely on the typical Git-based instruments anymore and will instead adopt a **new configuration management system**.
 
 Developers can manage *revisions* and *versions* from the dedicated sections inside the Project Overview area.
 
@@ -24,9 +25,9 @@ Versions can only be deleted by Project Administrators.
 
 ![Versions management page](img/versions-overview.png)
 
-## Revision history 
+## Revision history
 
-The Enhanced Workflow feature replaces the `Commit History` with the `Revision History`. 
+The Enhanced Workflow feature replaces the `Commit History` with the `Revision History`.
 The Revision History allows to keep track of how a revision has changed over time, tracking all past snapshots of the Project configuration saved by the users.
 
 <div style={{display: 'flex', justifyContent: 'center'}}>
@@ -41,17 +42,28 @@ Once that a revision is selected, its history is accessible in the Design Area b
 
 It contains the list of snapshots of the Project configuration on the current revision or version, created each time it has been saved.  
 It also includes useful information such as the snapshot date, author, associated message, and any tags associated with it.
-Moreover, the right-side button allows the user to visualize changes between the selected snapshot and the previous one, in order to better understand the configuration's evolution over time.
+Moreover, the document icon on the right side of the table allows the user to visualize changes between the selected snapshot and the previous one,
+in order to better understand the configuration's evolution over time.
 
 ![Diff Editor on Revision History modal](img/diff-editor-on-revision-history.png)
 
 :::tip
-From the revision history you can restore previous changes using the specific option in the contextual menu.
+From the revision history you can restore previous changes using the specific option in the contextual menu:
+click on the three dots icon, and then select *Restore these changes* to update the configuration to the selected snapshot.
 
 ![restore button](img/revision-history-restore-changes-button.png)
 :::
 
-#### Snaphot review 
+### Compare different revisions
+
+It is possible also to see the differences between to revisions by clicking *Select for compare* option in the menu of the revision you are interested:
+the selected revision will appear highlighted in the revision history and then you can select another revision by clicking the *Compare with selected* button.
+
+!["Compare with selected" button](img/compare-snapshots.png)
+
+After doing so, the comparison of the two configurations will be displayed to give the possibility to better understand the changes between the two revisions.
+
+### Snaphot review
 
 On the revision history, it is possible to click on a snapshot ID to access its configuration and review and edit it using the Design section.
 

docs/development_suite/set-up-infrastructure/img/revision-history-restore-changes-button.png

@@ -5,22 +5,12 @@ sidebar_label: v13.4.0
 image: "img/release-note-link-preview.png"
 ---
 
-_November 21th, 2024_
-
-:::info
-Mia-Platform Console v13.4.0 is **now in Preview** and will be generally available on December 5th.
-
-Console SaaS users can try out v13.4.0 latest improvements in Preview! Open a Service Request to ask for the creation of a sandbox Company in case you do not have access to any Company.
-
-For self-hosted installations, please read the [following guidelines](#how-to-update-your-console).
-:::
+_December 05th, 2024_
 
 ## Manage your resources from Mia-Platform Software Catalog
 
-
 In this release, we’ve enhanced the Software Catalog section with new features to improve resource management. Users can now create new items, as well as create new versions for items that support versioning, directly from the Console UI. Additionally, we’ve introduced the possibility to delete both individual items and their versions, offering more flexibility in managing resources within the Catalog. 
 
-
 For more details, please refer to [the documentation](/software-catalog/manage-items/software-catalog-ui/overview.md).
 
 ![software catalog add item](img/software-catalog-add-item.png)
@@ -192,4 +182,4 @@ The new version `3.1.0` comes with a security fix which redacts sensitive header
 
 ## How to update your Console
 
-For self-hosted installations, please head to the [self hosted upgrade guide](/infrastructure/self-hosted/installation-chart/100_how-to-upgrade.md) or contact your Mia-Platform referent and upgrade to _Console Helm Chart_ `v13.8.0-beta.3`.
+For self-hosted installations, please head to the [self hosted upgrade guide](/infrastructure/self-hosted/installation-chart/100_how-to-upgrade.md) or contact your Mia-Platform referent and upgrade to _Console Helm Chart_ `v13.8.1`.

docs/development_suite/set-up-infrastructure/img/revision-history.png

@@ -0,0 +1,147 @@
+---
+id: v13.5.0
+title: Version 13.5.0 Release Notes
+sidebar_label: v13.5.0
+image: "img/release-note-link-preview.png"
+---
+
+_December 5th, 2024_
+
+:::info
+Mia-Platform Console v13.5.0 is **now in Preview** and will be generally available on December 19th.
+
+Console SaaS users can try out v13.5.0 latest improvements in Preview! Open a Service Request to ask for the creation of a sandbox Company in case you do not have access to any Company.
+
+For self-hosted installations, please read the [following guidelines](#how-to-update-your-console).
+:::
+
+## Data Lineage
+
+Mia-Platform Data Catalog introduces the [Data Lineage](/data_catalog/frontend/data_lineage.mdx), a powerful tool for understanding, visualizing, and describing the flow and transformations of data within an organization.  
+
+This feature allows users to explore data relationships at two levels: **Table Lineage** and **System of Record (SoR) Lineage**, offering both detailed insights and a high-level overview. 
+
+![Data Lineage](img/data-lineage-overview.png)
+
+At the [Table-Level Lineage](/data_catalog/frontend/data_lineage.mdx#table-level-lineage), users can dive into the interconnections between individual tables, visualizing data flows and the transformations applied along the way. Users can also enrich the lineage with virtual assets and jobs, useful to complete relationships that have not yet been automatically retrieved, ensuring that context and purpose of data flows are thoroughly captured and properly described.  
+The [SoR-Level Lineage](/data_catalog/frontend/data_lineage.mdx#system-of-record-level-lineage) shows an aggregated view of data flows across Systems of Records, simplifying the identification of dependencies and bottlenecks at a broader scale, and clarifying how various systems interact within the organization.
+
+If you are using [Fast Data Control Plane](/fast_data/runtime_management/overview.mdx), the aggregation processes configured in your Fast Data Projects can be automatically captured in the Data Lineage, making Fast Data jobs visible on the Lineage canvas. To know more about how to acquire information from the Fast Data pipelines, visit the [related documentation](/data_catalog/data_catalog_job_runner.mdx#fast-data-jobs-sync).
+
+## Connections Management in Data Catalog Application
+
+The [Connections Management](/data_catalog/frontend/data_catalog_connections.mdx) feature in Mia-Platform Data Catalog enables users to retrieve and leverage metadata from [various supported providers](/data_catalog/frontend/data_catalog_connections.mdx#connection-providers), supporting critical operations such as [Asset Discovery](/data_catalog/frontend/data_catalog_assets.mdx) and [Lineage Analysis](/data_catalog/frontend/data_lineage.mdx).  
+
+![Data Catalog Connections Management](img/data-catalog-connections-management.png)
+
+Through the Connections Panel, users can manage the lifecycle of connections, from creation to deletion, and having access to a detailed overview of all configured connections.  
+Once a connection is established, assets can be imported directly into the Data Catalog using the Data Catalog Sync feature. To know more about the processes to update the state of the Data Catalog solution, visit the [following documentation](/data_catalog/data_catalog_job_runner.mdx#available-jobs).
+
+## Centralized management of the Container Registries 
+
+Gain more control over your container registries in your Projects! You can now easily manage and monitor them directly within your Project settings, where you can view, create, and delete them according to your purposes. 
+This update enables centralized monitoring and control of your registries, and allows you to specify the desired registry at the service level in the Design area.
+
+![Container Registry](img/container_registry.png)
+
+For more details, please refer to [the documentation](/console/project-configuration/project-settings.md#container-registries)
+
+## Enhanced Item Management: Edit Items in Mia-Platform Software Catalog
+
+In this release, we’ve introduced the ability to edit items in the Software Catalog, providing more flexibility in resource management. Non-versioned items can now be fully edited, allowing users to modify all aspects of the item. For versioned items, only the metadata can be edited, while any changes to the resources will still require creating a new version.
+
+![Edit Catalog Element](img/edit_catalog.png)
+
+For more details, please refer to [the documentation](/software-catalog/manage-items/software-catalog-ui/update/overview.md)
+
+## Introducing Snapshot Comparison through the history modal 
+
+Easily track changes to your configurations! Now you can compare any two snapshots side-by-side with our new visual comparison tool. Just head to the history modal and select the snapshots you want to analyze.
+
+For more details, please refer to [the documentation](/development_suite/set-up-infrastructure/revisions-and-versions.md)
+
+## Console
+
+### Improvements
+
+#### Allowing Secret key interpolation during the creation of an env variable from secret
+
+It is now possible to use public variables to interpolate the "Secret key" field when creating new environment variables "From Secret" on a microservice. This enhancement provides greater flexibility and automation when working with secrets, especially for complex deployments where secret keys might vary across environments.
+
+#### Infrastructure Resource
+
+The 'resourceId' of marketplace resources can now be modified after detachment, providing increased flexibility for resource organization at Runtime level.
+
+### Bug Fix
+
+This version addressed the following bugs:
+
+* fixed an issue where service/resource management badges were unavailable after a marketplace plugin/custom resource connection failed ;
+* fixed an issue where release notes for the current version of an instantiated resource were not displayed initially in the change version modal.
+
+## Fast Data
+
+### Fast Data Runtime Management
+
+The Fast Data Control Plane application has been updated to support the integration with Mia-Platform Data Catalog application for the [Data Lineage](#data-lineage) feature.  
+For more information, visit the [compatibility matrix documentation page](/fast_data/runtime_management/compatibility_matrix.md#service-latest-versions) with reported the latest service versions.
+
+## Microfrontend Composer
+
+### Back-Kit Library
+
+The new version `v1.5.11` of the back-kit library is available!
+
+Refer to back-kit [changelog](/microfrontend-composer/back-kit/changelog.md) for finer-grained details of new versions.
+
+#### Bug Fix
+
+* Fixed bk-table height when inside bk-layout-swap
+
+## Marketplace
+
+### Marketplace Updates
+
+#### Care Kit
+
+A new version `2.9.2` of Care Kit is out!
+
+The new version bring some fixes to the following components:
+
+- `ck-patient-dashboard`: Italian localization is now available
+- `ck-threshold-modal`: fixed a concurrency bug causing the component to show outdated thresholds  
+
+#### Chat Service Backend
+
+A new version `1.0.2` of Chat Service Backend is available!
+
+This version upgrades Node.js to v20 and fixes some documentation links.
+
+#### Notification Manager
+
+A new version `2.4.2` of Notification Manager is available!
+
+This version fixes a bug causing reminders not aborted correctly when an appointment was updated or deleted. 
+
+#### Swagger Aggregator
+
+##### Bug Fix
+
+From Swagger Aggregator version `3.8.2`, the `oauthFlows.password.tokenUrl` format has changed from `uri` to `uri-reference` in the OpenApi 3.1 schema
+
+#### Teleconsultation Service Frontend
+
+A new version `2.0.2` of the Teleconsultation Service Frontend is available!
+
+This version fixes a bug causing the UI language not matching sometimes the browser language.
+
+#### User Manager Service
+
+A new version `1.5.2` of the User Manager Service is available!
+
+This version upgrades Node.js to v20 and several dependencies, including `custom-plugin-lib` to v6.
+
+## How to update your Console
+
+For self-hosted installations, please head to the [self hosted upgrade guide](/infrastructure/self-hosted/installation-chart/100_how-to-upgrade.md) or contact your Mia-Platform referent and upgrade to _Console Helm Chart_ `v13.9.0-beta.0`.
+