OSDOCS-19528 Fix docs for the Developer perspective Observe UI Metrics etc

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[]
@@ -17,7 +20,7 @@ endif::[]
 ** *Build with guided documentation*: Follow the guided documentation to build applications and familiarize yourself with key concepts and terminologies.
 ** *Explore new developer features*: Explore the new features and resources within the *Developer* perspective.
 
-* *Developer catalog*: Explore the Developer Catalog to select the required applications, services, or source to image builders, and then add it to your project.
+* *Developer catalog*: Explore the Developer Catalog to select the required applications, services, or Source-to-Image (S2I) builders, and then add it to your project.
 ** *All Services*: Browse the catalog to discover services across {product-title}.
 ** *Database*: Select the required database service and add it to your application.
 ** *Operator Backed*: Select and deploy the required Operator-managed service.
@@ -51,10 +54,10 @@ The Managed services option is also available if the RHOAS Operator is installed
 
 * *Helm Chart repositories*: Use this option to add Helm Chart repositories in a namespace.
 
-* *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.
+* *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 is located.
 
 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 {pipelines-shortname} 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]
@@ -65,11 +68,11 @@ endif::openshift-rosa,openshift-rosa-hcp,openshift-dedicated[]
 [id="prerequisites_odc-creating-applications-using-developer-perspective"]
 == Prerequisites
 
-To create applications using the *Developer* perspective ensure that:
+To create applications by 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,17 @@ 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.redhat.com/en/documentation/monitoring_stack_for_red_hat_openshift/4.22[Monitoring stack for Red Hat OpenShift]
+* 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,26 +1,28 @@
 :_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::snippets/snip-unified-perspective-web-console.adoc[]
+
+include::modules/enabling-developer-perspective_web-console.adoc[leveloffset=+1]
+
+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]
 
@@ -31,4 +33,11 @@ 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]
+* link:https://docs.redhat.com/en/documentation/monitoring_stack_for_red_hat_openshift/4.22[Monitoring stack for Red Hat OpenShift]
+* 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]

authentication/assuming-an-aws-iam-role-for-a-service-account.adoc

@@ -1,6 +1,6 @@
 :_mod-docs-content-type: ASSEMBLY
 [id="assuming-an-aws-iam-role-for-a-service-account"]
-= Assuming an AWS IAM role for a service account
+= Assume an AWS IAM role for a service account
 
 include::_attributes/common-attributes.adoc[]
 ifdef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
@@ -34,7 +34,7 @@ include::modules/deploying-a-pod-that-includes-an-aws-sdk.adoc[leveloffset=+2]
 include::modules/verifying-the-assumed-iam-role-in-your-pod.adoc[leveloffset=+2]
 
 [role="_additional-resources"]
-[id="additional-resources_configuring-alert-notifications"]
+[id="additional-resources_{context}"]
 == Additional resources
 
 * link:https://docs.aws.amazon.com/eks/latest/userguide/iam-roles-for-service-accounts.html[AWS documentation on IAM roles for service accounts]

authentication/osd-admin-roles.adoc

@@ -1,6 +1,6 @@
 :_mod-docs-content-type: ASSEMBLY
 [id="osd-admin-roles"]
-= Managing administration roles and users
+= Manage administration roles and users
 include::_attributes/attributes-openshift-dedicated.adoc[]
 
 :context: osd-admin-roles

authentication/osd-revoking-cluster-privileges.adoc

@@ -1,6 +1,6 @@
 :_mod-docs-content-type: ASSEMBLY
 [id="osd-revoking-cluster-privileges"]
-= Revoking privileges and access to an {product-title} cluster
+= Revoke privileges and access to an {product-title} cluster
 
 include::_attributes/attributes-openshift-dedicated.adoc[]
 :context: osd-revoking-cluster-privileges

authentication/sd-configuring-identity-providers.adoc

@@ -26,7 +26,7 @@ include::modules/config-htpasswd-idp-webui.adoc[leveloffset=+2]
 include::modules/config-htpasswd-idp-from-file.adoc[leveloffset=+2]
 ifdef::openshift-rosa-hcp,openshift-rosa[]
 include::modules/rosa-config-htpasswd-idp-cli.adoc[leveloffset=+2]
-include::modules/rosa-config-htpasswd-idp-cli-file.adoc[leveloffset=+3]
+include::modules/rosa-config-htpasswd-idp-cli-file.adoc[leveloffset=+2]
 include::modules/config-htpasswd-idp-terraform.adoc[leveloffset=+2]
 endif::openshift-rosa-hcp,openshift-rosa[]
 ifdef::openshift-dedicated[]
@@ -43,5 +43,5 @@ ifdef::openshift-rosa[]
 * xref:../rosa_getting_started/rosa-sts-getting-started-workflow.adoc#rosa-sts-understanding-the-deployment-workflow[Understanding the ROSA with STS deployment workflow]
 endif::openshift-rosa[]
 * link:https://httpd.apache.org/docs/current/misc/password_encryptions.html[Apache Password Formats]
-* link:https://developers.google.com/identity/protocols/OpenIDConnect[Google's OpenID Connect integration]
-* link:http://openid.net/specs/openid-connect-core-1_0.html#CodeFlowAuth[Authorization Code Flow]
+* link:https://developers.google.com/identity/protocols/OpenIDConnect[Google OpenID Connect integration]
+* link:https://openid.net/specs/openid-connect-core-1_0.html#CodeFlowAuth[Authorization Code Flow]

cloud_experts_tutorials/cloud-experts-getting-started/cloud-experts-getting-started-idp.adoc

@@ -8,7 +8,7 @@ include::_attributes/attributes-openshift-dedicated.adoc[]
 toc::[]
 
 [role="_abstract"]
-To log in to your cluster, set up an identity provider (IDP). This tutorial uses GitHub as an example IDP. See the full list of xref:../../rosa_install_access_delete_clusters/rosa-sts-config-identity-providers.adoc#understanding-idp-supported_rosa-sts-config-identity-providers[IDPs supported by ROSA].
+To log in to your cluster, set up an identity provider (IDP). This tutorial uses GitHub as an example IDP. See the full list of xref:../../rosa_install_access_delete_clusters/rosa-sts-config-identity-providers.adoc#understanding-idp_rosa-sts-config-identity-providers[IDPs supported by ROSA].
 
 
 include::modules/cloud-experts-getting-started-idp-creating.adoc[leveloffset=+1]

modules/assuming-an-aws-iam-role-in-your-own-pods.adoc

@@ -4,7 +4,7 @@
 
 :_mod-docs-content-type: CONCEPT
 [id="assuming-an-aws-iam-role-in-your-own-pods_{context}"]
-= Assuming an AWS IAM role in your own pods
+= About assuming AWS IAM roles in your own pods
 
 [role="_abstract"]
 You can enable a service account to assume an AWS Identity and Access Management (IAM) role in a pod deployed in a user-defined project.

modules/authentication-overview.adoc

@@ -26,7 +26,7 @@ If you do not present a valid access token or certificate, your request is unaut
 ====
 
 ifdef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
-An administrator can configure authentication by configuring an identity provider. You can define any xref:../authentication/sd-configuring-identity-providers.adoc#understanding-idp-supported_sd-configuring-identity-providers[supported identity provider in {product-title}] and add it to your cluster.
+An administrator can configure authentication by configuring an identity provider. You can define any xref:../authentication/sd-configuring-identity-providers.adoc#understanding-idp_sd-configuring-identity-providers[supported identity provider in {product-title}] and add it to your cluster.
 endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
 
 ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]