RHIDP-5367 - Missing and incorrect information in "breaking changes" (#827)

* RHIDP-5367 - Missing and incorrect information in "breaking changes"

* Revert "RHIDP-5367 - Missing and incorrect information in "breaking changes""

This reverts commit 2329e8a.

* RHIDP-5367 - Missing and incorrect information in "breaking changes"

* Update modules/release-notes/ref-release-notes-breaking-changes.adoc

Co-authored-by: Nick Boldt <[email protected]>

* Update modules/release-notes/ref-release-notes-breaking-changes.adoc

Co-authored-by: Nick Boldt <[email protected]>

* Update ref-release-notes-breaking-changes.adoc

* Update ref-release-notes-breaking-changes.adoc

* Update ref-release-notes-breaking-changes.adoc

* Update modules/release-notes/ref-release-notes-breaking-changes.adoc

Co-authored-by: Heena Manwani <[email protected]>

* Update modules/release-notes/ref-release-notes-breaking-changes.adoc

Co-authored-by: Heena Manwani <[email protected]>

* Update modules/release-notes/ref-release-notes-breaking-changes.adoc

Co-authored-by: Heena Manwani <[email protected]>

* Update modules/release-notes/ref-release-notes-breaking-changes.adoc

Co-authored-by: Heena Manwani <[email protected]>

* Update modules/release-notes/ref-release-notes-breaking-changes.adoc

Co-authored-by: Heena Manwani <[email protected]>

* Update modules/release-notes/ref-release-notes-breaking-changes.adoc

Co-authored-by: Heena Manwani <[email protected]>

* Update modules/release-notes/ref-release-notes-breaking-changes.adoc

Co-authored-by: Heena Manwani <[email protected]>

* Update modules/release-notes/ref-release-notes-breaking-changes.adoc

Co-authored-by: Heena Manwani <[email protected]>

* Update ref-release-notes-breaking-changes.adoc

---------

Co-authored-by: Nick Boldt <[email protected]>
Co-authored-by: Heena Manwani <[email protected]>

Author: 3 people

modules/release-notes/ref-release-notes-breaking-changes.adoc

@@ -16,113 +16,56 @@ Prom-client metrics have been removed and replaced with OpenTelemetry metrics. A
 [id="feature-rhidp-4853"]
 == Plugins with updated scope
 
-Some plugins previously under the `@janus-idp` scope have moved to `@backstage/community`:
+To upgrade from {prod-short} 1.3 to 1.4, you must update your configuration to use the latest versions of the following plugins from the new scope.
+
+With this update, the following plugins, previously under the `@janus-idp` scope, have now been moved to the `@backstage-community` scope:
 
 [cols=2,%header]
 |===
-| Plugin Name
-| Plugin Name
-
-| `@janus-idp/backstage-plugin-acr`
-| `@backstage-community/plugin-acr`
-
-| `@janus-idp/backstage-plugin-azure-devops`
-| `@backstage-community/plugin-azure-devops`
-
-| `@janus-idp/backstage-plugin-azure-devops-backend`
-| `@backstage-community/plugin-azure-devops-backend`
-
-| `@janus-idp/backstage-plugin-3scale-backend`
-| `@backstage-community/plugin-3scale-backend`
-
-| `@janus-idp/backstage-plugin-dynatrace`
-| `@backstage-community/plugin-dynatrace`
-
-| `@janus-idp/backstage-plugin-github-actions`
-| `@backstage-community/plugin-github-actions`
-
-| `@janus-idp/backstage-plugin-github-issues`
-| `@backstage-community/plugin-github-issues`
-
-| `@janus-idp/backstage-plugin-jenkins`
-| `@backstage-community/plugin-jenkins`
-
-| `@janus-idp/backstage-plugin-jenkins-backend`
-| `@backstage-community/plugin-jenkins-backend`
-
-| `@janus-idp/backstage-plugin-keycloak-backend`
-| `@backstage-community/plugin-catalog-backend-module-keycloak`
-
-| `@janus-idp/backstage-plugin-tekton`
-| `@backstage-community/plugin-tekton`
-
-| `@janus-idp/backstage-plugin-tech-radar`
-| `@backstage-community/plugin-tech-radar`
-
-| `@janus-idp/backstage-plugin-tech-radar-backend`
-| `@backstage-community/plugin-tech-radar-backend`
-
-| `@janus-idp/backstage-plugin-sonarqube`
-| `@backstage-community/plugin-sonarqube`
-
-| `@janus-idp/backstage-plugin-sonarqube-backend`
-| `@backstage-community/plugin-sonarqube-backend`
-
-| `@janus-idp/backstage-plugin-lighthouse`
-| `@backstage-community/plugin-lighthouse`
-
-| `@janus-idp/backstage-plugin-nexus-repository-manager`
-| `@backstage-community/plugin-nexus-repository-manager`
-
-| `@janus-idp/backstage-plugin-topology`
-| `@backstage-community/plugin-topology`
-
-| `@janus-idp/backstage-plugin-jfrog-artifactory`
-| `@backstage-community/plugin-jfrog-artifactory`
-
-| `@janus-idp/backstage-plugin-ocm`
-| `@backstage-community/plugin-ocm`
-
-| `@janus-idp/backstage-plugin-ocm-backend`
-| `@backstage-community/plugin-ocm-backend`
-
-| `@janus-idp/backstage-plugin-rbac`
-| `@backstage-community/plugin-rbac`
-
-| `@janus-idp/backstage-plugin-redhat-argocd`
-| `backstage-community/plugin-redhat-argocd`
-
-| `@janus-idp/backstage-plugin-rbac-backend`
-| `@backstage-community/plugin-rbac-backend`
-
-| `@janus-idp/backstage-catalog-backend-module-pingidentity`
-| `@backstage-community/plugin-catalog-backend-module-pingidentity`
-
-| `@janus-idp/backstage-scaffolder-backend-module-regex`
-| `@backstage-community/plugin-scaffolder-backend-module-regex`
-
-| `@janus-idp/backstage-plugin-quay`
-| `@backstage-community/plugin-quay`
-
-| `@janus-idp/backstage-scaffolder-backend-module-sonarqube`
-| `@backstage-community/plugin-scaffolder-backend-module-sonarqube`
-
-| `@janus-idp/backstage-scaffolder-backend-module-servicenow`
-| `@backstage-community/plugin-scaffolder-backend-module-servicenow`
-
-| `@janus-idp/backstage-plugin-analytics-provider-segment`
-| `@backstage-community/plugin-analytics-provider-segment`
+| *RHDH 1.3 Plugin Name* 
+| *RHDH 1.4 Plugin Name*
+|`@janus-idp/backstage-plugin-acr`|`@backstage-community/plugin-acr`
+|`@janus-idp/backstage-plugin-acr`|`@backstage-community/plugin-acr`
+|`@janus-idp/backstage-plugin-analytics-provider-segment`|`@backstage-community/plugin-analytics-provider-segment`
+|`@janus-idp/backstage-plugin-jfrog-artifactory`|`@backstage-community/plugin-jfrog-artifactory`
+|`@janus-idp/backstage-plugin-keycloak-backend`|`@backstage-community/plugin-catalog-backend-module-keycloak`
+|`@janus-idp/backstage-plugin-nexus-repository-manager`|`@backstage-community/plugin-nexus-repository-manager`
+|`@janus-idp/backstage-plugin-ocm`|`@backstage-community/plugin-ocm`
+|`@janus-idp/backstage-plugin-ocm-backend`|`@backstage-community/plugin-ocm-backend`
+|`@janus-idp/backstage-plugin-quay`|`@backstage-community/plugin-quay`
+|`@janus-idp/backstage-plugin-rbac`|`@backstage-community/plugin-rbac`
+|`@janus-idp/backstage-plugin-tekton`|`@backstage-community/plugin-tekton`
+|`@janus-idp/backstage-plugin-topology`|`@backstage-community/plugin-topology`
+|`@janus-idp/backstage-scaffolder-backend-module-quay`|`@backstage-community/plugin-scaffolder-backend-module-quay`
+|`@janus-idp/backstage-scaffolder-backend-module-regex`|`@backstage-community/plugin-scaffolder-backend-module-regex`
+|`@janus-idp/backstage-scaffolder-backend-module-servicenow`|`@backstage-community/plugin-scaffolder-backend-module-servicenow`
+|`@janus-idp/backstage-scaffolder-backend-module-sonarqube`|`@backstage-community/plugin-scaffolder-backend-module-sonarqube`
+|===
 
-| `@janus-idp/backstage-plugin-scaffolder-backend-module-quay`
-| `@backstage-community/plugin-scaffolder-backend-module-quay`
+The following plugins, previously under the `@backstage` scope, have now been moved to the `@backstage-community` scope:
+[cols=2,%header]
+|===
+| *RHDH 1.3 Plugin Name* 
+| *RHDH 1.4 Plugin Name*
+|`@backstage/plugin-azure-devops`|`@backstage-community/plugin-azure-devops`
+|`@backstage/plugin-azure-devops-backend`|`@backstage-community/plugin-azure-devops-backend`
+|`@backstage/plugin-dynatrace`|`@backstage-community/plugin-dynatrace`
+|`@backstage/plugin-github-actions`|`@backstage-community/plugin-github-actions`
+|`@backstage/plugin-github-issues`|`@backstage-community/plugin-github-issues`
+|`@backstage/plugin-jenkins`|`@backstage-community/plugin-jenkins`
+|`@backstage/plugin-jenkins-backend`|`@backstage-community/plugin-jenkins-backend`
+|`@backstage/plugin-lighthouse`|`@backstage-community/plugin-lighthouse`
+|`@backstage/plugin-sonarqube`|`@backstage-community/plugin-sonarqube`
+|`@backstage/plugin-sonarqube-backend`|`@backstage-community/plugin-sonarqube-backend`
+|`@backstage/plugin-tech-radar`|`@backstage-community/plugin-tech-radar`
 |===
 
-Two plugins previously under the @janus-idp scope have moved to @red-hat-developer-hub:
+Two plugins previously under the `@janus-idp` scope have moved to `@red-hat-developer-hub` scope:
 
 [cols=2,%header]
 |===
-| Plugin Name
-| {product-very-short}
+| *RHDH 1.3 Plugin Name* 
+| *RHDH 1.4 Plugin Name*
 
 | `@janus-idp/backstage-plugin-bulk-import`
 | `@red-hat-developer-hub/backstage-plugin-bulk-import`
@@ -131,3 +74,18 @@ Two plugins previously under the @janus-idp scope have moved to @red-hat-develop
 | `@red-hat-developer-hub/backstage-plugin-bulk-import-backend`
 |===
 
+With the update to the plugin scope, the dynamic plugin configuration has also been modified.
+
+[cols=2,%header]
+|===
+|*RHDH 1.3 Configuration*|*RHDH 1.4 Configuration*
+|link:https://github.com/janus-idp/backstage-showcase/blob/release-1.3/dynamic-plugins.default.yaml[dynamic-plugins.default.yaml]|link:https://github.com/janus-idp/backstage-showcase/blob/release-1.4/dynamic-plugins.default.yaml[dynamic-plugins.default.yaml]
+|===
+
+.Procedure
+* To upgrade from {product-very-short} 1.3 to {product-very-short} 1.4, you must update your configuration to use the latest versions of the plugins listed previously from the new scope.
+
+[NOTE]
+====
+In addition to the previously provided tables, you can compare the link:https://github.com/redhat-developer/red-hat-developers-documentation-rhdh/blob/release-1.4/modules/dynamic-plugins/rhdh-supported-plugins.csv[RHDH 1.4 CSV file] with the link:https://github.com/redhat-developer/red-hat-developers-documentation-rhdh/blob/release-1.3/modules/dynamic-plugins/rhdh-supported-plugins.csv[RHDH 1.3 CSV file] to identify the changes in dynamic plugins.
+====