OSDOCS-19528 Fix obsolete docs for the Developer perspective Observe UI and AEM prep

Author: michelle-purcell

applications/creating_applications/odc-creating-applications-using-developer-perspective.adoc

@@ -6,6 +6,9 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
+[role="_abstract"]
+Create and deploy applications on {product-title} by using the Developer perspective in the web console.
+
 The *Developer* perspective in the web console provides you the following options from the *+Add* view to create applications and associated services and deploy them on {product-title}:
 
 ifndef::openshift-enterprise,openshift-webscale[]
@@ -54,7 +57,7 @@ The Managed services option is also available if the RHOAS Operator is installed
 * *Re-ordering of resources*: Use these resources to re-order pinned resources added to your navigation pane. The drag-and-drop icon is displayed on the left side of the pinned resource when you hover over it in the navigation pane. The dragged resource can be dropped only in the section where it resides.
 
 ifdef::openshift-enterprise,openshift-webscale[]
-Note that certain options, such as *Pipelines*, *Event Source*, and *Import Virtual Machines*, are displayed only when the link:https://docs.openshift.com/pipelines/latest/install_config/installing-pipelines.html#op-installing-pipelines-operator-in-web-console_installing-pipelines[OpenShift Pipelines Operator], link:https://docs.openshift.com/serverless/1.28/install/install-serverless-operator.html#serverless-install-web-console_install-serverless-operator[{ServerlessOperatorName}], and xref:../../virt/install/installing-virt.adoc#virt-subscribing-cli_installing-virt[OpenShift Virtualization Operator] are installed, respectively.
+Note that certain options, such as *Pipelines*, *Event Source*, and *Import Virtual Machines*, are displayed only when the OpenShift Pipelines Operator, {ServerlessOperatorName}, and OpenShift Virtualization Operator are installed, respectively.
 endif::[]
 // dedicated-admin cannot install the Serverless or Virtualization operators, cannot create namespace.
 // xref: ../../cicd/pipelines/installing-pipelines.adoc#op-installing-pipelines-operator-in-web-console_installing-pipelines[OpenShift Pipelines Operator]
@@ -68,8 +71,8 @@ endif::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
 To create applications using the *Developer* perspective ensure that:
 
 ifndef::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
-* You have xref:../../web_console/web-console.adoc#web-console[logged in to the web console].
-* You have created a project or have access to a project with the appropriate xref:../../authentication/using-rbac.adoc#default-roles_using-rbac[roles and permissions] to create applications and other workloads in {product-title}.
+* You have logged in to the web console.
+* You have created a project or have access to a project with the appropriate roles and permissions to create applications and other workloads in {product-title}.
 endif::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
 ifdef::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
 * You have logged in to the web console.
@@ -81,8 +84,8 @@ ifdef::openshift-enterprise,openshift-webscale[]
 
 To create serverless applications, in addition to the preceding prerequisites, ensure that:
 
-* You have link:https://docs.openshift.com/serverless/1.28/install/install-serverless-operator.html#install-serverless-operator[installed the {ServerlessOperatorName}].
-* You have link:https://docs.openshift.com/serverless/1.28/install/installing-knative-serving.html#installing-knative-serving[created a `KnativeServing` resource in the `knative-serving` namespace].
+* You have installed the {ServerlessOperatorName}.
+* You have created a `KnativeServing` resource in the `knative-serving` namespace.
 
 endif::[]
 
@@ -104,8 +107,16 @@ include::modules/odc-using-the-developer-catalog-to-add-services-or-components.a
 [id="additional-resources_odc-creating-applications-using-developer-perspective"]
 == Additional resources
 
-* For more information about Knative routing settings for {ServerlessProductName}, see link:https://docs.openshift.com/serverless/1.28/knative-serving/external-ingress-routing/routing-overview.html#routing-overview[Routing].
-* For more information about domain mapping settings for {ServerlessProductName}, see link:https://docs.openshift.com/serverless/1.28/knative-serving/config-custom-domains/serverless-custom-domains.html#serverless-custom-domains[Configuring a custom domain for a Knative service].
-* For more information about Knative autoscaling settings for {ServerlessProductName}, see link:https://docs.openshift.com/serverless/1.28/knative-serving/autoscaling/serverless-autoscaling-developer.html#serverless-autoscaling-developer[Autoscaling].
-* For more information about adding a new user to a project, see xref:../../applications/projects/working-with-projects.adoc#odc-providing-project-permissions-using-developer-perspective_projects[Working with projects].
-* For more information about creating a Helm Chart repository, see xref:../../applications/working_with_helm_charts/configuring-custom-helm-chart-repositories.adoc#odc-creating-helm-releases-using-developer-perspective_configuring-custom-helm-chart-repositories[Creating Helm Chart repositories].
+* xref:../../web_console/web-console-overview.adoc#enabling-developer-perspective_web-console[Enabling the Developer perspective in the web console]
+* xref:../../web_console/web-console.adoc#web-console[Accessing the web console]
+* xref:../../authentication/using-rbac.adoc#default-roles_using-rbac[Default cluster roles]
+* link:https://docs.openshift.com/pipelines/latest/install_config/installing-pipelines.html#op-installing-pipelines-operator-in-web-console_installing-pipelines[Installing the {pipelines-shortname} Operator]
+* link:https://docs.openshift.com/serverless/1.28/install/install-serverless-operator.html#serverless-install-web-console_install-serverless-operator[Installing the {ServerlessOperatorName}]
+* link:https://docs.openshift.com/serverless/1.28/install/install-serverless-operator.html#install-serverless-operator[Installing the {ServerlessOperatorName}]
+* link:https://docs.openshift.com/serverless/1.28/install/installing-knative-serving.html#installing-knative-serving[Creating a KnativeServing resource]
+* xref:../../virt/install/installing-virt.adoc#virt-subscribing-cli_installing-virt[Installing the OpenShift Virtualization Operator]
+* link:https://docs.openshift.com/serverless/1.28/knative-serving/external-ingress-routing/routing-overview.html#routing-overview[Knative routing settings for {ServerlessProductName}]
+* link:https://docs.openshift.com/serverless/1.28/knative-serving/config-custom-domains/serverless-custom-domains.html#serverless-custom-domains[Configuring a custom domain for a Knative service]
+* link:https://docs.openshift.com/serverless/1.28/knative-serving/autoscaling/serverless-autoscaling-developer.html#serverless-autoscaling-developer[Knative autoscaling settings for {ServerlessProductName}]
+* xref:../../applications/projects/working-with-projects.adoc#odc-providing-project-permissions-using-developer-perspective_projects[Working with projects]
+* xref:../../applications/working_with_helm_charts/configuring-custom-helm-chart-repositories.adoc#odc-creating-helm-releases-using-developer-perspective_configuring-custom-helm-chart-repositories[Creating Helm Chart repositories]

applications/odc-monitoring-project-and-application-metrics-using-developer-perspective.adoc

@@ -1,34 +1,38 @@
 :_mod-docs-content-type: ASSEMBLY
-[id="odc-monitoring-project-and-application-metrics-using-developer-perspective"]
-= Monitoring project and application metrics using the Developer perspective
+[id="odc-monitoring-project-and-application-metrics-using-developer-perspective_{context}"]
+= Monitor project and application metrics by using the Developer perspective
 include::_attributes/common-attributes.adoc[]
 :context: odc-monitoring-project-and-application-metrics-using-developer-perspective
 
 toc::[]
 
-
-The *Observe* view in the *Developer* perspective provides options to monitor your project or application metrics, such as CPU, memory, and bandwidth usage, and network related information.
+[role="_abstract"]
+The *Observe* view in the *Developer* perspective enables you to monitor project and application metrics to track performance, troubleshoot issues, and respond to alerts. For example, CPU, memory, and bandwidth usage, and network related information.
 
 [id="prerequisites_odc-monitoring-project-and-application-metrics-using-developer-perspective"]
 == Prerequisites
 
-* You have xref:../applications/creating_applications/odc-creating-applications-using-developer-perspective.adoc#odc-creating-applications-using-developer-perspective[created and deployed applications on {product-title}].
-ifndef::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
-* You have xref:../web_console/web-console.adoc#web-console[logged in to the web console] and have switched to xref:../web_console/web-console-overview.adoc#about-developer-perspective_web-console-overview[the *Developer* perspective].
-endif::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
-ifdef::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
-* You have logged in to the web console and have switched to the *Developer* perspective.
-endif::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
+* You have created and deployed applications on {product-title}.
+* You have logged in to the web console.
+* The *Developer* perspective is enabled and you have switched to it.
+
+include::../modules/con_monitoring-capabilities-in-the-developer-perspective.adoc[leveloffset=+1]
 
-include::modules/odc-monitoring-your-project-metrics.adoc[leveloffset=+1]
+include::../modules/proc_view-project-dashboards.adoc[leveloffset=+1]
 
-include::modules/odc-monitoring-your-application-metrics.adoc[leveloffset=+1]
+include::../modules/odc-monitoring-your-application-metrics.adoc[leveloffset=+1]
 
-include::modules/odc-image-vulnerabilities-breakdown.adoc[leveloffset=+1]
+include::../modules/odc-image-vulnerabilities-breakdown.adoc[leveloffset=+1]
 
-include::modules/odc-monitoring-your-app-vulnerabilities.adoc[leveloffset=+1]
+include::../modules/odc-monitoring-your-app-vulnerabilities.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 [id="additional-resources-odc-monitoring-project-and-application-metrics-using-developer-perspective"]
 == Additional resources
-* link:https://docs.redhat.com/en/documentation/monitoring_stack_for_red_hat_openshift/latest/html/about_monitoring/about-ocp-monitoring[About {product-title} monitoring]
+* xref:../web_console/web-console-overview.adoc#enabling-developer-perspective_web-console[Enabling the Developer perspective in the web console]
+* xref:../observability/monitoring/accessing-metrics/accessing-metrics-as-a-developer.adoc#accessing-metrics-as-a-developer[Accessing metrics as a developer]
+* xref:../observability/monitoring/managing-alerts/managing-alerts-as-a-developer.adoc#managing-alerts-as-a-developer[Managing alerts as a Developer]
+* xref:../observability/monitoring/about-ocp-monitoring/about-ocp-monitoring.adoc#about-ocp-monitoring[About {product-title} monitoring]
+* xref:../applications/creating_applications/odc-creating-applications-using-developer-perspective.adoc#odc-creating-applications-using-developer-perspective[Creating applications by using the Developer perspective]
+* xref:../web_console/web-console.adoc#web-console[Accessing the web console]
+* xref:../web_console/web-console-overview.adoc#about-developer-perspective_web-console-overview[About the Developer perspective]

modules/con_monitoring-capabilities-in-the-developer-perspective.adoc

@@ -0,0 +1,44 @@
+// Module included in the following assemblies:
+//
+// * applications/odc-monitoring-project-and-application-metrics-using-developer-perspective.adoc
+
+:_newdoc-version: 2.18.7
+:_template-generated: 2026-08-03
+:_mod-docs-content-type: CONCEPT
+
+[id="monitoring-capabilities-in-the-developer-perspective_{context}"]
+= Observe view in the Developer perspective
+
+[role="_abstract"]
+The Observe view in the Developer perspective provides monitoring tools filtered by your project access permissions to track performance, troubleshoot issues, and respond to alerts. You can monitor CPU, memory, bandwidth, and network metrics.
+
+include::snippets/snip-unified-perspective-web-console.adoc[]
+
+The *Observe* view in the *Developer* perspective uses the same monitoring components as the *Administrator* perspective, but displays only the projects you have permissions for. You can monitor your applications without seeing cluster-wide metrics you cannot access.
+
+After selecting a project in the *Observe* view, the following tabs become available:
+
+* *Events*: Cluster events filtered by the selected project
+* *Alerting rules*: Configured alerting rules and their current state
+* *Alerts*: Firing alerts for the selected project
+* *Dashboards*: Pre-built visual dashboards showing resource consumption graphs including CPU usage, memory usage, bandwidth consumption, and network-related information
+* *Metrics*: Prometheus query interface for analyzing specific metrics
+* *Silences*: Create and manage alert silences to temporarily suppress alert notifications
+
+The monitoring interface is the same as the *Administrator* perspective, with the key difference being project filtering based on your access permissions.
+
+[NOTE]
+====
+In the *Administrator* perspective, the monitoring tabs are immediately available with a project dropdown for filtering. In the *Developer* perspective, you must select a project before the tabs appear. This scoping enables your developers to observe their applications by using the same monitoring tools as cluster administrators, focused only on their assigned projects.
+====
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../web_console/web-console-overview.adoc#enabling-developer-perspective_web-console[Enabling the Developer perspective in the web console]
+* xref:../observability/monitoring/managing-alerts/managing-alerts-as-a-developer.adoc#monitoring-accessing-the-alerting-ui_managing-alerts-as-a-developer[Accessing the Alerting UI]
+* xref:../observability/monitoring/managing-alerts/managing-alerts-as-a-developer.adoc#managing-alerting-rules-for-user-defined-projects-uwm_managing-alerts-as-a-developer[Managing alerting rules for user-defined projects]
+* xref:../observability/monitoring/managing-alerts/managing-alerts-as-a-developer.adoc#managing-alerts-as-a-developer[Managing alerts as a Developer]
+* xref:../observability/monitoring/accessing-metrics/accessing-metrics-as-a-developer.adoc#reviewing-monitoring-dashboards-developer_accessing-metrics-as-a-developer[Reviewing monitoring dashboards as a developer]
+* xref:../observability/monitoring/accessing-metrics/accessing-metrics-as-a-developer.adoc#querying-metrics-for-user-defined-projects-with-mon-dashboard_accessing-metrics-as-a-developer[Querying metrics for user-defined projects]
+* xref:../observability/monitoring/managing-alerts/managing-alerts-as-a-developer.adoc#managing-silences_managing-alerts-as-a-developer[Managing silences]

modules/enabling-developer-perspective_web-console.adoc

@@ -4,9 +4,11 @@
 
 :_mod-docs-content-type: PROCEDURE
 [id="enabling-developer-perspective_web-console_{context}"]
-= Enabling the *Developer* perspective in the web console
+= Enable the Developer perspective in the web console
 
 [role="_abstract"]
+Enable the Developer perspective in the web console to give your developers tools to manage applications, visualize topology, and monitor projects as they develop and build them.
+
 ifndef::openshift-rosa-hcp[]
 Starting with {product-title} 4.19, the perspectives in the web console have unified. There is no longer a *Developer* perspective by default; however, cluster administrators can enable the *Developer* perspective for developers to use.
 endif::openshift-rosa-hcp[]
@@ -22,17 +24,17 @@ You can enable the *Developer* perspective with the following steps:
 
 .Procedure
 
-. Navigate to the *Cluster Settings* page by clicking  *Administration* -> *Cluster Settings*.
+. Navigate to the *Cluster Settings* page by clicking menu:Administration[Cluster Settings].
 
-. Select the *Configuration* tab on the *Cluster Settings* page.
+. Select the *Configuration* tab.
 
-. Type `console` in the search to locate the Console Operator resource and select `operator.openshift.io`.
+. Type `console` in the search field to locate the Console Operator resource and select `operator.openshift.io`.
 
 . On the *Cluster Details* page, click the *Actions* menu and select *Customize*.
 
 . In the *General* tab, locate the *Perspectives* section. You can enable or disable the *Developer* perspective as needed. Changes are automatically applied.
 
-. Optional: You can enable the *Developer* perspective with the CLI by running the following command:
+. Optional: You can enable the *Developer* perspective by using the CLI with the following command:
 +
 [source,terminal]
 ----
@@ -41,5 +43,10 @@ $ oc patch console.operator.openshift.io/cluster --type='merge' -p '{"spec":{"cu
 +
 [NOTE]
 ====
-It will take some time for the change to reflect in the web console as the console pod restarts.
-====
+The change will reflect in the web console after the console pod restarts successfully.
+====
+
+.Verification
+
+. Locate the perspective switcher in the upper-left corner of the web console.
+. Verify that *Developer* is displayed as an available perspective option.

modules/monitoring-about-monitoring-dashboards.adoc

@@ -6,6 +6,7 @@
 [id="about-monitoring-dashboards_{context}"]
 = About monitoring dashboards
 
+[role="_abstract"]
 {product-title} provides a set of monitoring dashboards that help you understand the state of cluster components and user-defined workloads.
 
 include::snippets/snip-unified-perspective-web-console.adoc[]
@@ -21,3 +22,8 @@ As an administrator, you can access dashboards for the core {product-title} comp
 * Node performance metrics
 
 // to do: add a new image
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../web_console/web-console-overview.adoc#enabling-developer-perspective_web-console[Enabling the Developer perspective in the web console]

modules/monitoring-reviewing-monitoring-dashboards-admin.adoc

@@ -6,7 +6,8 @@
 [id="reviewing-monitoring-dashboards-admin_{context}"]
 = Reviewing monitoring dashboards as a cluster administrator
 
-As an administrator, you can view dashboards relating to core {product-title} cluster components.
+[role="_abstract"]
+View pre-built dashboards for core {product-title} cluster components to monitor system health and performance.
 
 include::snippets/snip-unified-perspective-web-console.adoc[]
 
@@ -38,3 +39,8 @@ endif::openshift-dedicated,openshift-rosa[]
 . Optional: Select a *Refresh interval*.
 
 . Hover over each of the graphs within a dashboard to display detailed information about specific items.
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../web_console/web-console-overview.adoc#enabling-developer-perspective_web-console[Enabling the Developer perspective in the web console]

modules/monitoring-reviewing-monitoring-dashboards-developer.adoc

@@ -6,15 +6,16 @@
 [id="reviewing-monitoring-dashboards-developer_{context}"]
 = Reviewing monitoring dashboards as a developer
 
-As a developer, you can view dashboards relating to projects you have permissions for.
+[role="_abstract"]
+View pre-built dashboards for projects you have permissions for to monitor application health and resource consumption.
 
 include::snippets/snip-unified-perspective-web-console.adoc[]
 
 .Prerequisites
 
 * You have access to the cluster as a developer or as a user.
 * You have view permissions for the project that you are viewing the dashboard for.
-* A cluster administrator has link:https://docs.redhat.com/en/documentation/openshift_container_platform/latest/html-single/web_console/index#enabling-developer-perspective_web-console_web-console-overview[enabled the *Developer* perspective] in the web console.
+* A cluster administrator has enabled the *Developer* perspective in the web console.
 
 .Procedure
 
@@ -37,3 +38,8 @@ include::snippets/snip-unified-perspective-web-console.adoc[]
 . Optional: Select a *Refresh interval*.
 
 . Hover over each of the graphs within a dashboard to display detailed information about specific items.
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../web_console/web-console-overview.adoc#enabling-developer-perspective_web-console[Enabling the Developer perspective in the web console]