Merge pull request #187 from Chr1st1anSears/new-environments-doc

New envs section with new overview doc

Author: jc-berger

docs/modules/ROOT/nav-how-to-guides.adoc

@@ -11,11 +11,13 @@
 *** xref:how-to-guides/testing_applications/surface-level_tests.adoc[Surface-level tests]
 *** xref:how-to-guides/testing_applications/proc_adding_an_integration_test.adoc[Adding an integration test]
 *** xref:how-to-guides/testing_applications/proc_creating_custom_test.adoc[Creating a custom integration test]
+** Managing environments
+*** xref:how-to-guides/managing-environments/con_overview_of_environments.adoc[Overview of {ProductName} environments]
+*** xref:how-to-guides//managing-environments/proc_creating_your_own_environment.adoc[Creating your own environment]
 ** Securing your supply chain
 *** xref:how-to-guides/Secure-your-supply-chain/proc_inspect_sbom.adoc[Inspecting SBOMs]
 *** xref:how-to-guides/Secure-your-supply-chain/proc_inspect-slsa-provenance.adoc[Downloading your SLSA provenance]
 *** xref:how-to-guides/Secure-your-supply-chain/proc_java_dependencies.adoc[Configuring dependencies rebuild for Java apps in the CLI]
-** xref:how-to-guides/proc_creating_your_own_environment.adoc[Creating your own environment]
 ** xref:how-to-guides/proc_managing-compliance-with-the-enterprise-contract.adoc[Managing compliance with the Enterprise Contract]
 ** xref:how-to-guides/proc_delete_application.adoc[Deleting an application]
 

docs/modules/ROOT/pages/getting-started/get-started.adoc

@@ -140,7 +140,7 @@ image::Environments.png[The Environments tab shows the type of your environment,
 
 An environment is a set of compute resources that you can use to develop, test, and stage your applications. There is a development environment included for you so that you can explore {ProductName}.
 
-For information about creating an application with your own cluster, refer to xref:how-to-guides/proc_creating_your_own_environment.adoc[Creating your own environment].
+For information about creating an application with your own cluster, refer to xref:how-to-guides/managing-environments/proc_creating_your_own_environment.adoc[Creating your own environment].
 
 === Examining your SBOM
 

docs/modules/ROOT/pages/how-to-guides/managing-environments/con_overview_of_environments.adoc

@@ -0,0 +1,27 @@
+= Overview of {ProductName} environments
+
+Environments represent infrastructure. You can use them to test, develop, and release your application to production. You can create two types of environments in {ProductName}:
+
+* Static environments, to which you can deploy your application for development or production.
+* Temporary (ephemeral) environments, to which you can temporarily deploy your application during testing.
+
+The following sections further explain these different environments and how you can use them.
+
+== Static environments
+
+By default, {ProductName} deploys your application to AWS through Red Hat OpenShift Service on AWS (ROSA). This default static environment runs your application for as long as you want. But you can host your application in a different static environment, using a bring your own cluster (BYOC) option.
+
+Currently, with the BYOC option, you can use a static environment hosted by any of the major cloud providers — AWS, Azure, GCP, etc.  
+
+== Temporary environments   
+
+You might want to deploy your application as part of a custom integration test. For example, you might want to test if endpoints react in an expected manner, or to see if components react correctly to API queries. 
+
+Normally, {ProductName} runs integration tests in the static development environment. But to deploy your application during a test, you need a new environment. The static development environment might already host the latest version of your application. 
+
+This is the use case for temporary environments. You can configure {ProductName} to deploy your application to a temporary clone of the development environment. You can perform this configuration when adding an integration test. {ProductName} then clones the environment each time it performs the test. The temporary environment disappears after testing. 
+
+== Additional resources
+
+* xref:how-to-guides/managing-environments/proc_creating_your_own_environment.adoc[Creating your own environment] with the BYOC option  
+* xref:how-to-guides/testing_applications/proc_adding_an_integration_test.adoc[Adding an integration test] (step 7 discusses temporary environments)