Merge pull request #64699 from mburke5678/applications-fix-errors

Applications docs fixes during ROSA review

Author: mburke5678

_topic_maps/_topic_map.yml

@@ -2131,9 +2131,9 @@ Topics:
     File: odc-creating-applications-using-developer-perspective
   - Name: Creating applications from installed Operators
     File: creating-apps-from-installed-operators
-  - Name: Creating applications using the CLI
+  - Name: Creating applications by using the CLI
     File: creating-applications-using-cli
-- Name: Viewing application composition using the Topology view
+- Name: Viewing application composition by using the Topology view
   File: odc-viewing-application-composition-using-topology-view
 - Name: Exporting applications
   File: odc-exporting-applications

applications/config-maps.adoc

@@ -10,10 +10,12 @@ Config maps allow you to decouple configuration artifacts from image content to
 
 The following sections define config maps and how to create and use them.
 
-For information on creating config maps, see xref:../nodes/pods/nodes-pods-configmaps.adoc[Creating and using config maps].
-
 include::modules/nodes-pods-configmap-overview.adoc[leveloffset=+1]
 
+.Additional resources
+
+* xref:../nodes/pods/nodes-pods-configmaps.adoc[Creating and using config maps]
+
 [id="nodes-pods-config-maps-consuming-configmap-in-pods"]
 == Use cases: Consuming config maps in pods
 

applications/connecting_applications_to_services/installing-sbo.adoc

@@ -26,4 +26,6 @@ include::modules/op-installing-sbo-operator-using-the-web-console.adoc[leveloffs
 
 
 == Additional Resources
+
 * xref:../../applications/connecting_applications_to_services/getting-started-with-service-binding.adoc#getting-started-with-service-binding[Getting started with service binding].
+

applications/connecting_applications_to_services/odc-connecting-an-application-to-a-service-using-the-developer-perspective.adoc

@@ -11,11 +11,11 @@ toc::[]
 
 Use the *Topology* view for the following purposes:
 
-** Group multiple components within an application.
+* Grouping multiple components within an application.
 
-** Connect components with each other.
+* Connecting components with each other.
 
-** Connect multiple resources to services with labels.
+* Connecting multiple resources to services with labels.
 
 You can either use a binding or a visual connector to connect components.
 
@@ -33,5 +33,5 @@ include::modules/odc-visualizing-the-binding-connections-to-resources.adoc[level
 [role="_additional-resources"]
 [id="additional-resources-odc-connecting-an-application-to-a-service-using-the-developer-perspective"]
 == Additional resources
-* xref:../../applications/connecting_applications_to_services/getting-started-with-service-binding.adoc#getting-started-with-service-binding[Getting started with service binding].
-* link:https://github.com/redhat-developer/service-binding-operator#known-bindable-operators[Known bindable Operators].
+* xref:../../applications/connecting_applications_to_services/getting-started-with-service-binding.adoc#getting-started-with-service-binding[Getting started with service binding]
+* link:https://github.com/redhat-developer/service-binding-operator#known-bindable-operators[Known bindable Operators]

applications/connecting_applications_to_services/understanding-service-binding-operator.adoc

@@ -20,4 +20,4 @@ include::modules/sbo-api-differences.adoc[leveloffset=+1]
 [role="_additional-resources"]
 [id="additional-resources_understanding-sbo"]
 == Additional resources
-* xref:../../applications/connecting_applications_to_services/getting-started-with-service-binding.adoc#getting-started-with-service-binding[Getting started with service binding].
+* xref:../../applications/connecting_applications_to_services/getting-started-with-service-binding.adoc#getting-started-with-service-binding[Getting started with service binding]

applications/creating_applications/creating-applications-using-cli.adoc

@@ -1,6 +1,6 @@
 :_mod-docs-content-type: ASSEMBLY
 [id="creating-applications-using-cli"]
-= Creating applications using the CLI
+= Creating applications by using the CLI
 include::_attributes/common-attributes.adoc[]
 :context: creating-applications-using-cli
 

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

@@ -1,6 +1,6 @@
 :_mod-docs-content-type: ASSEMBLY
 [id="odc-creating-applications-using-developer-perspective"]
-= Creating applications using the Developer perspective
+= Creating applications by using the Developer perspective
 include::_attributes/common-attributes.adoc[]
 :context: odc-creating-applications-using-developer-perspective
 

applications/index.adoc

@@ -13,7 +13,7 @@ Using {product-title}, you can create, edit, delete, and manage applications usi
 
 Using projects, you can organize and manage applications in isolation. You can manage the entire project lifecycle, including xref:../applications/projects/working-with-projects.adoc#working-with-projects[creating, viewing, and deleting a project] in {product-title}.
 
-After you create the project, you can xref:../applications/projects/working-with-projects.adoc#odc-providing-project-permissions-using-developer-perspective_projects[grant or revoke access to a project] and xref:../applications/projects/working-with-projects.adoc#odc-customizing-available-cluster-roles-using-developer-perspective_projects[manage cluster roles] for the users using the Developer perspective. You can also xref:../applications/projects/configuring-project-creation.adoc#configuring-project-creation[edit the project configuration resource] while creating a project template that is used for automatic provisioning of new projects.
+After you create the project, you can xref:../applications/projects/working-with-projects.adoc#odc-providing-project-permissions-using-developer-perspective_projects[grant or revoke access to a project] and xref:../applications/projects/working-with-projects.adoc#odc-customizing-available-cluster-roles-using-the-web-console_projects[manage cluster roles] for the users using the Developer perspective. You can also xref:../applications/projects/configuring-project-creation.adoc#configuring-project-creation[edit the project configuration resource] while creating a project template that is used for automatic provisioning of new projects.
 
 ifndef::openshift-rosa,openshift-dedicated[]
 Using the CLI, you can xref:../applications/projects/creating-project-other-user.adoc#creating-project-other-user[create a project as a different user] by impersonating a request to the {product-title} API. When you make a request to create a new project, the {product-title} uses an endpoint to provision the project according to a customizable template. As a cluster administrator, you can choose to xref:../applications/projects/configuring-project-creation.adoc#disabling-project-self-provisioning_configuring-project-creation[prevent an authenticated user group from self-provisioning new projects].
@@ -28,14 +28,15 @@ endif::openshift-rosa,openshift-dedicated[]
 [id="creating-application"]
 === Creating an application
 
-To create applications, you must have created a project or have access to a project with the appropriate roles and permissions. You can create an application by using either xref:../applications/creating_applications/odc-creating-applications-using-developer-perspective.adoc#odc-creating-applications-using-developer-perspective[the Developer perspective in the web console], xref:../applications/creating_applications/creating-apps-from-installed-operators.adoc#creating-apps-from-installed-operators[installed Operators], or xref:../applications/creating_applications/creating-applications-using-cli.adoc#creating-applications-using-cli[the {product-title} CLI]. You can source the applications to be added to the project from Git, JAR files, devfiles, or the developer catalog.
+To create applications, you must have created a project or have access to a project with the appropriate roles and permissions. You can create an application by using either xref:../applications/creating_applications/odc-creating-applications-using-developer-perspective.adoc#odc-creating-applications-using-developer-perspective[the Developer perspective in the web console], xref:../applications/creating_applications/creating-apps-from-installed-operators.adoc#creating-apps-from-installed-operators[installed Operators], or xref:../applications/creating_applications/creating-applications-using-cli.adoc#creating-applications-using-cli[the {oc-first}]. You can source the applications to be added to the project from Git, JAR files, devfiles, or the developer catalog.
 
-You can also use components that include source or binary code, images, and templates to create an application by using the {product-title} CLI. With the {product-title} web console, you can create an application from an Operator installed by a cluster administrator.
+You can also use components that include source or binary code, images, and templates to create an application by using the {oc-first}. With the {product-title} web console, you can create an application from an Operator installed by a cluster administrator.
 
 [id="maintaining-application"]
 === Maintaining an application
 
-After you create the application you can use the web console to xref:../applications/odc-monitoring-project-and-application-metrics-using-developer-perspective.adoc#odc-monitoring-project-and-application-metrics-using-developer-perspective[monitor your project or application metrics]. You can also xref:../applications/odc-editing-applications.adoc#odc-editing-applications[edit] or xref:../applications/odc-deleting-applications.adoc#odc-deleting-applications[delete] the application using the web console.  
+After you create the application, you can use the web console to xref:../applications/odc-monitoring-project-and-application-metrics-using-developer-perspective.adoc#odc-monitoring-project-and-application-metrics-using-developer-perspective[monitor your project or application metrics]. You can also xref:../applications/odc-editing-applications.adoc#odc-editing-applications[edit] or xref:../applications/odc-deleting-applications.adoc#odc-deleting-applications[delete] the application using the web console.  
+
 When the application is running, not all applications resources are used. As a cluster administrator, you can choose to xref:../applications/idling-applications.adoc#idling-applications[idle these scalable resources] to reduce resource consumption.
 
 [id="connecting-application"]

applications/odc-viewing-application-composition-using-topology-view.adoc

@@ -1,6 +1,6 @@
 :_mod-docs-content-type: ASSEMBLY
 [id="odc-viewing-application-composition-using-topology-view"]
-= Viewing application composition using the Topology view
+= Viewing application composition by using the Topology view
 include::_attributes/common-attributes.adoc[]
 :context: viewing-application-composition-using-topology-view
 

applications/projects/working-with-projects.adoc

@@ -37,26 +37,53 @@ In {product-title} clusters that use the Customer Cloud Subscription (CCS) model
 ====
 endif::openshift-dedicated[]
 
-include::modules/creating-a-project-using-the-web-console.adoc[leveloffset=+1]
+[id="working-with-projects-create-project"]
+== Creating a project
 
-include::modules/odc-creating-projects-using-developer-perspective.adoc[leveloffset=+1]
+You can use the {product-title} web console or the {oc-first} to create a project in your cluster.
 
-include::modules/creating-a-project-using-the-CLI.adoc[leveloffset=+1]
+include::modules/creating-a-project-using-the-web-console.adoc[leveloffset=+2]
 
-include::modules/viewing-a-project-using-the-web-console.adoc[leveloffset=+1]
+// include modules/odc-creating-projects-using-developer-perspective.adoc[leveloffset=+2]
 
-include::modules/viewing-a-project-using-the-CLI.adoc[leveloffset=+1]
+.Additional resources
+
+* xref:../../applications/projects/working-with-projects.adoc#odc-customizing-available-cluster-roles-using-the-web-console_projects[Customizing the available cluster roles using the web console]
+
+include::modules/creating-a-project-using-the-CLI.adoc[leveloffset=+2]
+
+[id="working-with-projects-viewing-project"]
+== Viewing a project
+
+You can use the {product-title} web console or the {oc-first} to view a project in your cluster.
+
+include::modules/viewing-a-project-using-the-web-console.adoc[leveloffset=+2]
+
+include::modules/viewing-a-project-using-the-CLI.adoc[leveloffset=+2]
 
 include::modules/odc-providing-project-permissions-using-developer-perspective.adoc[leveloffset=+1]
 
-include::modules/odc-customizing-available-cluster-roles-using-developer-perspective.adoc[leveloffset=+1]
+include::modules/odc-customizing-available-cluster-roles-using-the-web-console.adoc[leveloffset=+1]
 
 include::modules/adding-to-a-project.adoc[leveloffset=+1]
 
-include::modules/checking-project-status-using-the-web-console.adoc[leveloffset=+1]
+[id="working-with-projects-viewing-project-status"]
+== Checking the project status
+
+You can use the {product-title} web console or the {oc-first} to view the status of your project.
+
+include::modules/checking-project-status-using-the-web-console.adoc[leveloffset=+2]
+
+include::modules/checking-project-status-using-the-CLI.adoc[leveloffset=+2]
+
+// The following text comes from deleting-a-project-using-the-CLI.adoc
+[id="working-with-projects-deleting-project"]
+== Deleting a project
+
+You can use the {product-title} web console or the {oc-first} to delete a project.
 
-include::modules/checking-project-status-using-the-CLI.adoc[leveloffset=+1]
+When you delete a project, the server updates the project status to *Terminating* from *Active*. Then, the server clears all content from a project that is in the *Terminating* state before finally removing the project. While a project is in *Terminating* status, you cannot add new content to the project. Projects can be deleted from the CLI or the web console.
 
-include::modules/deleting-a-project-using-the-web-console.adoc[leveloffset=+1]
+include::modules/deleting-a-project-using-the-web-console.adoc[leveloffset=+2]
 
-include::modules/deleting-a-project-using-the-CLI.adoc[leveloffset=+1]
+include::modules/deleting-a-project-using-the-CLI.adoc[leveloffset=+2]