Merge pull request #93644 from opayne1/OSDOCS-12145

OSDOCS#12145: Updates to the web console overview for 4.19

Author: opayne1

modules/about-administrator-perspective.adoc renamed to modules/about-administrator_web-console.adoc

@@ -4,23 +4,18 @@
 
 :_mod-docs-content-type: CONCEPT
 [id="about-administrator-perspective_{context}"]
-= About the Administrator perspective in the web console
+= Administrator role in the web console
 
-The *Administrator* perspective enables you to view the cluster inventory, capacity, general and specific utilization information, and the stream of important events, all of which help you to simplify planning and troubleshooting tasks. Both project administrators and cluster administrators can view the *Administrator* perspective.
+The cluster administrator role enables you to view the cluster inventory, capacity, general and specific utilization information, and the stream of important events, all of which help you to simplify planning and troubleshooting tasks. Both project administrators and cluster administrators can use all features in the web console.
 
 Cluster administrators can also open an embedded command-line terminal instance with the web terminal Operator in {product-title} 4.7 and later.
 
-[NOTE]
-====
-The default web console perspective that is shown depends on the role of the user. The *Administrator* perspective is displayed by default if the user is recognized as an administrator.
-====
-
 The *Administrator* perspective provides workflows specific to administrator use cases, such as the ability to:
 
 * Manage workload, storage, networking, and cluster settings.
-* Install and manage Operators using the Operator Hub.
+* Install and manage Operators using the OperatorHub.
 * Add identity providers that allow users to log in and manage user access through roles and role bindings.
 * View and manage a variety of advanced settings such as cluster updates, partial cluster updates, cluster Operators, custom resource definitions (CRDs), role bindings, and resource quotas.
 * Access and manage monitoring features such as metrics, alerts, and monitoring dashboards.
 * View and manage logging, metrics, and high-status information about the cluster.
-* Visually interact with applications, components, and services associated with the *Administrator* perspective in {product-title}.
+* Visually interact with applications, components, and services.

modules/about-developer-perspective.adoc renamed to modules/about-developer_web-console.adoc

@@ -3,10 +3,10 @@
 // web_console/web-console-overview.adoc
 
 :_mod-docs-content-type: CONCEPT
-[id="about-developer-perspective_{context}"]
-= About the Developer perspective in the web console
+[id="about-developer_web-console_{context}"]
+= Developer role in the web console
 
-The *Developer* perspective offers several built-in ways to deploy applications, services, and databases. In the *Developer* perspective, you can:
+The developer role in the web console offers several built-in ways to deploy applications, services, and databases. With the developer role, you can:
 
 * View real-time visualization of rolling and recreating rollouts on the component.
 * View the application status, resource utilization, project event streaming, and quota consumption.
@@ -15,12 +15,7 @@ The *Developer* perspective offers several built-in ways to deploy applications,
 
 Cluster administrators can also open an embedded command-line terminal instance in the web console in {product-title} 4.7 and later.
 
-[NOTE]
-====
-The default web console perspective that is shown depends on the role of the user. The *Developer* perspective is displayed by default if the user is recognised as a developer.
-====
-
-The *Developer* perspective provides workflows specific to developer use cases, such as the ability to:
+Developers have access to workflows specific to their use cases, such as the ability to:
 
 * Create and deploy applications on {product-title} by importing existing codebases, images, and container files.
 * Visually interact with applications, components, and services associated with them within a project and monitor their deployment and build status.

modules/enabling-developer-perspective_web-console.adoc

@@ -0,0 +1,40 @@
+// Module included in the following assemblies:
+//
+// web_console/web-console-overview.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="enabling-developer-perspective_web-console_{context}"]
+= Enabling the *Developer* perspective in the web console
+
+
+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.
+
+You can enable the *Developer* perspective with the following steps:
+
+.Prerequisites
+
+* You have access to the web console as a user with `cluster-admin` privileges.
+
+.Procedure
+
+. Navigate to the *Cluster Settings* page by clicking  *Administration* -> *Cluster Settings*.
+
+. Select the *Configuration* tab on the *Cluster Settings* page.
+
+. Type `console` in the search 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:
++
+[source,terminal]
+----
+$ oc patch console.operator.openshift.io/cluster --type='merge' -p '{"spec":{"customization":{"perspectives":[{"id":"dev","visibility":{"state":"Enabled"}}]}}}'
+----
++
+[NOTE]
+====
+It will take some time for the change to reflect in the web console as the console pod restarts.
+====

web_console/web-console-overview.adoc

@@ -6,22 +6,21 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-The Red Hat {product-title} web console provides a graphical user interface to visualize your project data and perform administrative, management, and troubleshooting tasks. The web console runs as pods on the control plane nodes in the openshift-console project. It is managed by a `console-operator` pod. Both *Administrator* and *Developer* perspectives are supported.
+The Red Hat {product-title} web console provides a graphical user interface to visualize your project data and perform administrative, management, and troubleshooting tasks. The web console runs as pods on the control plane nodes in the openshift-console project. It is managed by a `console-operator` pod.
 
-Both *Administrator* and *Developer* perspectives enable you to create quick start tutorials for {product-title}. A quick start is a guided tutorial with user tasks and is useful for getting oriented with an application, Operator, or other product offering.
+include::snippets/unified-perspective-web-console.adoc[]
 
-include::modules/about-administrator-perspective.adoc[leveloffset=+1]
-include::modules/about-developer-perspective.adoc[leveloffset=+1]
-include::modules/odc-accessing-perspectives.adoc[leveloffset=+1]
+You can create quick start tutorials for {product-title} that provide guided steps within the web console with user tasks. They are helpful for getting oriented with an application, Operator, or other product offering.
+
+include::modules/about-administrator_web-console.adoc[leveloffset=+1]
+include::modules/about-developer_web-console.adoc[leveloffset=+1]
+include::modules/enabling-developer-perspective_web-console.adoc[leveloffset=+1]
 
 [role="_additional-resources"]
 .Additional resources
 
 ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
 * xref:../welcome/learn_more_about_openshift.adoc#cluster-administrator[Learn more about Cluster Administrator]
-// TODO: Update once this is moved to the About book
-// * xref  :../getting_started/openshift-overview.adoc#for-administrators[Overview of the *Administrator* perspective]
-* xref:../applications/creating_applications/odc-creating-applications-using-developer-perspective.adoc#odc-creating-applications-using-developer-perspective[Creating and deploying applications on {product-title} using the *Developer* perspective]
 * xref:../applications/odc-viewing-application-composition-using-topology-view.adoc#odc-viewing-application-composition-using-topology-view[Viewing the applications in your project, verifying their deployment status, and interacting with them in the *Topology* view]
 endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
 * xref:../web_console/using-dashboard-to-get-cluster-information.adoc#using-dashboard-to-get-cluster-info[Viewing cluster information]

web_console/web-console.adoc

@@ -7,22 +7,14 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-The {product-title} web console is a user interface accessible from a web browser.
-Developers can use the web console to visualize, browse, and manage the contents
-of projects.
+The {product-title} web console is a user interface accessible from a web browser. You can use the web console to visualize, browse, and manage the contents of projects.
 
 == Prerequisites
 
-* JavaScript must be enabled to use the web console. For the best experience, use
-a web browser that supports
-link:http://caniuse.com/#feat=websockets[WebSockets].
-* Review the link:https://access.redhat.com/articles/4128421[OpenShift Container
-Platform 4.x Tested Integrations] page before you create the supporting
-infrastructure for your cluster.
+* You must use one of the following supported web browsers: Edge, Chrome, Safari, or Mozilla Firefox. IE 11 and earlier is not supported.
+* Review the link:https://access.redhat.com/articles/4128421[OpenShift ContainerPlatform 4.x Tested Integrations] page before you create the supporting infrastructure for your cluster.
 
 include::modules/web-console-overview.adoc[leveloffset=+1]
-// include::modules/multi-cluster-about.adoc[leveloffset=+1]
-//include::modules/enabling-multi-cluster-console.adoc[leveloffset=+2]
 
 ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
 [role="_additional-resources"]