final first draft of VZ section (#161)

* final first draft of VZ section

* fix copy and paste error

Author: rosemarymarano

documentation/staging/1.3/content/navigate/_index.md

@@ -27,6 +27,10 @@ The UI sections are:
   - [WebLogic Domain]({{< relref "/navigate/kubernetes/k8s-weblogic-domain.md" >}})
   - [Ingress Controller]({{< relref "/navigate/kubernetes/k8s-ingress-controller.md" >}})
 - [Verrazzano]({{< relref "/navigate/verrazzano/_index.md" >}})
+  - [Client Configuration]({{< relref "/navigate/verrazzano/vz-client-config.md" >}})
+  - [Installation]({{< relref "/navigate/verrazzano/vz-install.md" >}})
+  - [Component]({{< relref "/navigate/verrazzano/vz-component.md" >}})
+  - [Application]({{< relref "/navigate/verrazzano/vz-application.md" >}})  
 
 
 At the bottom of the page, the collapsed `Console` panel automatically appears and displays the `stdout` and `stderr`

documentation/staging/1.3/content/navigate/verrazzano/vz-application.md

@@ -7,16 +7,21 @@ description: "Define and deploy a Verrazzano application."
 ---
 
 ### Contents
+- [Verrazzano Application](#verrazzano-application)
 - [Design View](#design-view)
     - [Components](#components)
 - [Code View](#code-view)
 - [Deploy Application](#deploy-application)
 - [Undeploy Application](#undeploy-application)
 
 
+### Verrazzano Application
+A Verrazzano application is comprised of Components. Components encapsulate application implementation details.
+For detailed information, see [Applications](https://verrazzano.io/latest/docs/applications/) in the Verrazzano documentation.
+
 ### Design View
-`Design View` lets you specify the data used to define the Verrazzano application.
-Simply provide values for the following fields:
+`Design View` lets you specify the data used to define an Verrazzano application.
+Start by providing values for the following fields:
 
 - `Application Name` - The name of the Verrazzano application.
 - `Application Namespace` - The Kubernetes namespace to which the application will be deployed.
@@ -30,11 +35,17 @@ Simply provide values for the following fields:
    - `Verrazzano Clusters for Application Placement` - The Verrazzano cluster names where the application should be placed. To edit this field, click `Choose Verrazzano Clusters`.
 
 #### Components
+You can apply Traits to customize Components for the environment. Traits customize Component workloads and generate related resources during deployment.
 
+Use the `Add Components` button to apply Traits to your application:
+- Ingress Trait - provides a simplified integration with the Istio Ingress Gateway included in the Verrazzano platform.
+- Manual Scalar - lets you specify the desired replica count.
+- Metrics Trait - provides a simplified integration with the Prometheus service included in the Verrazzano platform.
+- Logging Trait - contains the configuration for an additional logging sidecar with a custom image and Fluentd configuration file.
 
 ### Code View
-`Code View` displays shell scripts for installing an ingress controller and for updating ingress routes.  It also
-displays the YAML definitions of the routes to be added, if applicable.
+`Code View` displays a shell script for deploying the Verrazzano application for the WebLogic domain into Kubernetes
+as well as the application YAML resource definition and project resource, if applicable.
 
 If it is not already selected, then use the `Script Language` drop-down menu to choose the desired scripting language.  Note
 that the application is providing a working sample script simply to show how the process might be automated.  Before
@@ -45,12 +56,13 @@ the script itself.  This change is left as an exercise for you because different
 existing standards for securely handling such credentials.
 
 ### Deploy Application
-`Deploy Application` creates the Domain custom resource object and any of its dependent objects (for example,
-namespace, secrets, ConfigMap) in Kubernetes.  You access this action by using the `Deploy Domain` button on the
-`WebLogic Domain` page or the `Go` > `Deploy WebLogic Domain to Kubernetes` menu item.
+`Deploy Application` deploys the application to Verrazzano. You access this action by using the `Deploy Application` button
+or the `Go` > `Deploy Verrazzano Application` menu item.
 
 ### Undeploy Application
-`Undeploy Application` removes the Kubernetes custom resource for the WebLogic domain and its
-dependent objects in Kubernetes. In addition, you can choose whether to also delete the corresponding namespace.
-You access these actions by using the `Undeploy Domain` button on the
-`WebLogic Domain` page or the `Go` > `Undeploy WebLogic Domain to Kubernetes` menu item.
+`Undeploy Application` removes the Verrazzano application from the WebLogic domain and its
+dependent objects in Kubernetes. Undeploying the application stops the pods associated with the application.
+In addition, you can choose whether to also delete the corresponding namespace.
+Removing the application namespace removes all applications, components, secrets, ConfigMaps, and other
+Kubernetes objects that exist in the Kubernetes namespace. You access these actions by using the `Undeploy Application` button
+or the `Go` > `Undeploy Verrazzano Application` menu item.

documentation/staging/1.3/content/navigate/verrazzano/vz-component.md

@@ -239,12 +239,15 @@ surfaced here because the `Clusters` pane of the `Design View` is populated only
 
 ### Deploy Component
 `Deploy Component` creates the domain custom object and any of its dependent objects (for example,
-namespace, secrets, ConfigMap) in Kubernetes.  You access this action by using the `Deploy Component` button on the
-`Component` page or the `Go` > `Deploy Verrazzano Component` menu item.  
+namespace, secrets, ConfigMap) in Kubernetes.  You access this action by using the `Deploy Component` button
+or the `Go` > `Deploy Verrazzano Component` menu item.  
 
 
 ### Undeploy Component
 `Undeploy Component` removes the domain custom object for the WebLogic domain and its
-dependent objects in Kubernetes. In addition, you can choose whether to also delete the corresponding namespace.
-You access these actions by using the `Undeploy Component` button on the
-`Component` page or the `Go` > `Undeploy Verrazzano Component` menu item.
+dependent objects in Kubernetes. Undeploying the Verrazzano component will make any Verrazzano applications
+referencing these components invalid. In addition, you can choose whether to also delete the corresponding namespace. 
+Removing the Verrazzano components' namespace removes all applications, components, secrets, ConfigMaps, and other
+Kubernetes objects that exist in the Kubernetes namespace.
+You access these actions by using the `Undeploy Component` button
+or the `Go` > `Undeploy Verrazzano Component` menu item.

documentation/staging/1.3/content/navigate/verrazzano/vz-install.md

@@ -1,5 +1,5 @@
 ---
-title: "Install Verrazzano"
+title: "Installation"
 date: 2019-02-22T15:44:42-05:00
 draft: false
 weight: 2
@@ -27,13 +27,13 @@ provide values for the following fields:
 
 - `Install Name` - The name to give the Verrazzano object during installation.
 - `Install Profile` - The Verrazzano installation profile; the choices are: `Dev` (default) and `Production`.
-- `Release Version` - Required. Select a Verrazzano release version.
+- `Release Version` - Required. Select the desired Verrazzano release version.
 - `Install Jaeger` - Optional. Select whether to install the Jaeger transaction tracing component. If selected, then provide
    the percentage of Istio requests to be traced in Jaeger in the `Istio Tracing Sampling Rate` field.
 
 
 ### Code View
-The `Install Script` displays a shell script that you can use as a starting point for automating the
+`Install Script` displays a shell script that you can use as a starting point for automating the
 installation of Verrazzano into Kubernetes.   
 
 If it is not already selected, then use the `Script Language` drop-down menu to choose the desired scripting language.  Note
@@ -44,7 +44,7 @@ set environment variables to specify any credentials required by the script to e
 the script itself.  This change is left as an exercise for you because different environments typically will have
 existing standards for securely handling such credentials.
 
-The `Verrazzano Resource` displays the Verrazzano resource definition that you've specified.
+`Verrazzano Resource` displays the Verrazzano resource definition that you've specified.
 
 ### Install Verrazzano
 `Install Verrazzano` installs Verrazzano in the target Kubernetes cluster.