Update prereq information in docs (#1299)

* update prereq information in docs

* update prereq information in docs

* update prereq information in docs

* explicitly state support for oke, olc4k and aks

* explicitly state support for oke, olc4k and aks

* just say authorized cloud environments, link, and leave it at that

* just say authorized cloud environments, link, and leave it at that

* just say authorized cloud environments, link, and leave it at that

Author: markxnelson

docs-source/content/_index.md

@@ -21,6 +21,10 @@ The [current release of the operator](https://github.com/oracle/weblogic-kuberne
 This release was published on August 27th, 2019.
 ***
 
+{{% notice note %}}
+Please review the prerequisites and supported environments [here]({{< relref "/userguide/introduction/introduction" >}}).
+{{% /notice %}}
+
 #### Operator earlier versions
 
 Documentation for prior releases of the operator is available [here](https://github.com/oracle/weblogic-kubernetes-operator/blob/master/site/README.md).

docs-source/content/userguide/introduction/introduction.md

@@ -23,18 +23,49 @@ Detailed instructions are available [here]({{< relref "/userguide/managing-opera
 * Oracle WebLogic Server 12.2.1.3.0 with patch 29135930.
    * The existing WebLogic Docker image, `container-registry.oracle.com/middleware/weblogic:12.2.1.3 `,
    has all the necessary patches applied.
-   * A `docker pull` is required if you pulled the image prior to that date.
    * Check the WLS version with `docker run container-registry.oracle.com/middleware/weblogic:12.2.1.3 sh -c` `'source $ORACLE_HOME/wlserver/server/bin/setWLSEnv.sh > /dev/null 2>&1 && java weblogic.version'`.
    * Check the WLS patches with `docker run container-registry.oracle.com/middleware/weblogic:12.2.1.3 sh -c` `'$ORACLE_HOME/OPatch/opatch lspatches'`.
 * You must have the `cluster-admin` role to install the operator.
+* We do not currently support running WebLogic in non-Linux containers. 
+
+### Cloud providers
+
+The Oracle [Global Pricing and Licensing site](https://www.oracle.com/corporate/pricing/specialty-topics.html)
+provides details about licensing practices and policies. 
+WebLogic Server and the operator are supported on "Authorized Cloud Environments" as defined in
+[this Oracle licensing policy](https://www.oracle.com/assets/cloud-licensing-070579.pdf) and 
+[this list of eligible products](http://www.oracle.com/us/corporate/pricing/authorized-cloud-environments-3493562.pdf).
+
+The official document that defines the [supported configurations is here](https://www.oracle.com/middleware/technologies/ias/oracleas-supported-virtualization.html).
+
+In accordance with these policies, the operator and WebLogic Server are supported on Oracle Cloud
+Infrastructure using *Oracle Container Engine for Kubernetes*, or in a cluster running *Oracle Linux
+Container Servies for use with Kubernetes* on OCI Compute; and on "authorized cloud environments".
 
 ### OpenShift
 
-Operator 2.0.1+ is certified for use on OpenShift 3.11.43+, with Kubernetes 1.11.5+.  OpenShift 4 certification is currently in progress.
+Operator 2.0.1+ is certified for use on OpenShift Container Platform 3.11.43+, with Kubernetes 1.11.5+.  OpenShift 4 certification is currently in progress.
 
 When using the operator in OpenShift, the `anyuid` security context constraint is required to ensure that WebLogic containers run with a UNIX UID that has the correct permissions on the domain filesystem.
 For more information, see [OpenShift]({{<relref "/security/openshift.md">}}) in the Security section.
 
+### Important note about development-focused Kubernetes distributions
+
+There are a number of development-focused distributions of Kubernetes, like kind, Minikube, Minishift and so on.
+Often these run Kubernetes in a virtual machine on your development machine.  We have found that these distributions
+present some extra challenges in areas like:
+
+* Separate Docker image stores, making it necessary to save/load images to move them between Docker file systems,
+* Default virtual machine file sizes and resource limits that are too small to run WebLogic or hold the necessary images,
+* Storage providers that do not always support the features that the operator and/or WebLogic rely on, 
+* Load balancing implementations that do not always support the features that the operator and/or WebLogic rely on.
+
+As such, we *do not* recommend using these distributions to run the operator and/or WebLogic, and we do not 
+provide support for WebLogic or the operator running in these distributions.
+
+We have found that Docker for Desktop does not seem to suffer the same limitations, and we do support that as a
+dev/test option. 
+
 ### Operator Docker image
 
 You can find the operator image in

docs-source/content/userguide/overview/k8s-setup.md

@@ -17,7 +17,7 @@ If you need some help setting up a Kubernetes environment to experiment with the
 "Development/test" options:
 
 * Install [Docker for Mac](https://docs.docker.com/docker-for-mac/#kubernetes) and enable its embedded Kubernetes cluster (or register for the [Docker for Windows](https://beta.docker.com/form) beta and wait until Kubernetes is available there).
-* Install [Minikube](https://github.com/kubernetes/minikube) on your Windows/Linux/Mac computer.
+* We *do not* recommend or support other development/test options like Minikube, Minishift, kind, and so on.
 
 We have provided our hints and tips for several of these options in the sections below.