Doc 6 (#654)

* udpate install doc to reference richard's helm doc

* update toc

* tidying up the toc

Author: markxnelson

site/install.md

@@ -3,21 +3,21 @@
 
 ## Create and manage the operator
 
-An operator is an application-specific controller that extends Kubernetes to create, configure, and manage instances of complex applications. The WebLogic Kubernetes Operator follows the standard Kubernetes Operator pattern, and simplifies the management and operation of WebLogic domains and deployments. You can find the operator image in [Docker Hub](https://hub.docker.com/r/oracle/weblogic-kubernetes-operator/).
+An operator is an application-specific controller that extends Kubernetes to create, configure, and manage instances 
+of complex applications. The Oracle WebLogic Server Kubernetes Operator follows the standard Kubernetes operator pattern, and 
+simplifies the management and operation of WebLogic domains and deployments. 
 
-In your Kubernetes cluster you can have one or more operators that manage one or more WebLogic domains (running in a cluster). We provide a Helm chart to create the operator. (Point to the documentation and sample that describes how to do the steps below.)
 
+You can have one or more operators in your Kubernetes cluster that manage one or more WebLogic domains each. 
+We provide a Helm chart to manage the installation and configuration of the operator and that is the 
+*preferred method* of managing operators.  Detailed instructions are available [here](helm-charts.md).
 
-### Starting the operator
+If, for some reason, you do not want to use Helm, it is still possible to perform a manual 
+installation of the operator.  This is *not the recommended approach*, but is fully [documented here](manual-installation.md)
+if you wish to use this approach.
 
-* Create the namespace and service account for the operator (See the script and doc that describe how to do these.)
-* Edit the operator input YAML
-* Start the operator with a Helm chart
+### Operator Docker image
 
-### Modifying the operator
-
-(images, RBAC roles, ...)
-
-### Shutting down the operator
-(See the operator sample README section that describes how to shutdown and delete all resources for the operator.)
+You can find the operator image in 
+[Docker Hub](https://hub.docker.com/r/oracle/weblogic-kubernetes-operator/).
 

site/user-guide.md

@@ -1,22 +1,29 @@
 # User Guide
 
-**TOOO** put intro here
+This document provides detailed information that is targeted at the user of the Oracle WebLogic 
+Server Kubernetes Operator.  It provides instructions on how to install the operator in your 
+Kubernetes cluster and how to use it to manage WebLogic domains.  
+
+If you are looking for information about how the operator is designed, implemented, built, etc., then 
+you should refer to the [Developer guide](developer.md).
 
 ## Table of contents
 
-**TODO** this is not the final TOC - we will restructure/reorganize for usability....
+The information in this guide is organized in the order that you would most likely need to use it.  If you 
+want to set up an operator and use it to create and manage WebLogic domains, you should 
+follow this guide from top to bottom, and the necessary information will be 
+presented in the correct order.
 
 * [Important terms](#important-terms)
 * [Getting started](#getting-started)
 * [Prerequisites](#prerequisites)
-* [Preparing your Kubernetes environment](prepare-k8s.md)
+* [Preparing your Kubernetes environment to run the operator](prepare-k8s.md)
   * [Set up your Kubernetes cluster](prepare-k8s.md#set-up-your-kubernetes-cluster)
   * [Set up load balancers](load-balancing.md)
   * [Configuring Kibana and Elasticsearch](prepare-k8s.md#configuring-kibana-and-elasticsearch)
-* [Create and manage the operator](install.md)
-  * [Starting the operator](install.md#starting-the-operator)
-  * [Modifying the operator](install.md#modifying-the-operator)
-  * [Shutting down the operator](install.md#shutting-down-the-operator)
+* [Install and manage the operator](install.md)
+  * [Using the Helm charts](helm-charts.md) is the *preferred* method
+  * [Manual installation](manual-installation.md) is also possible
 * [Creating or obtaining WebLogic Docker images](weblogic-docker-images.md)
   * [Obtaining standard images from the Docker store](weblogic-docker-images.md#obtaining-standard-images-from-the-docker-store)
   * [Creating a custom images with patches applied](weblogic-docker-images.md#creating-a-custom-images-with-patches-applied)