This commit promotes the SOA samples and documentation to master. (#1297)

In addition it picks up the updated hugo theme, which will fix
some rendering issues.

Author: markxnelson

docs-source/config.toml

@@ -5,6 +5,9 @@ title = "WebLogic Kubernetes Operator"
 # Change the default theme to be use when building the site with Hugo
 theme = "hugo-theme-learn"
 
+# disable the copy to clipboard links
+disableInlineCopyToClipBoard = true
+
 publishDir = "docs"
 
 # analytics

docs-source/content/samples/simple/domains/delete-domain/_index.md

@@ -1,7 +1,7 @@
 ---
 title: "Delete domain resources"
 date: 2019-02-23T17:32:31-05:00
-weight: 4
+weight: 6
 description: "Delete the domain resources created while executing the samples."
 ---
 

docs-source/content/samples/simple/domains/domain-home-on-pv/_index.md

@@ -1,7 +1,7 @@
 ---
 title: "Domain home on a PV"
 date: 2019-02-23T17:32:31-05:00
-weight: 2
+weight: 4
 description: "Sample for creating a WebLogic domain home on an existing PV or PVC, and the domain resource YAML file for deploying the generated WebLogic domain."
 ---
 

docs-source/content/samples/simple/domains/fmw-domain/_index.md

@@ -32,7 +32,7 @@ The following prerequisites must be handled prior to running the create domain s
   with an inputs file that has the `domainUID` set to `domain1`.
 * Create the Kubernetes secrets `username` and `password` of the administrative account in the same Kubernetes
   namespace as the domain.
-* Configure access to your database. For details, see [here]({{< relref "/userguide/managing-domains/fmw-infra/_index.md#configuring-access-to-your-database" >}}).  
+* Configure access to your database. For details, see [here]({{< relref "/userguide/managing-fmw-domains/fmw-infra/_index.md#configuring-access-to-your-database" >}}).  
 * Create a Kubernetes secret with the RCU credentials. For details, refer to this [document](https://github.com/oracle/weblogic-kubernetes-operator/blob/master/kubernetes/samples/scripts/create-rcu-credentials/README.md).
 
 #### Use the script to create a domain
@@ -115,7 +115,7 @@ The following parameters can be provided in the inputs file.
 | `domainUID` | Unique ID that will be used to identify this particular domain. Used as the name of the generated WebLogic domain as well as the name of the Kubernetes domain resource. This ID must be unique across all domains in a Kubernetes cluster. This ID cannot contain any character that is not valid in a Kubernetes service name. | `domain1` |
 | `exposeAdminNodePort` | Boolean indicating if the Administration Server is exposed outside of the Kubernetes cluster. | `false` |
 | `exposeAdminT3Channel` | Boolean indicating if the T3 administrative channel is exposed outside the Kubernetes cluster. | `false` |
-| `image` | WebLogic Docker image. The operator requires FMW Infrastructure 12.2.1.3.0 with patch 29135930 applied. Refer to [FMW Infrastructure domains]({{< relref "/userguide/managing-domains/fmw-infra/_index.md#obtaining-the-fmw-infrastructure-docker-image" >}}) for details on how to obtain or create the image. | `container-registry.oracle.com/middleware/fmw-infrastructure:12.2.1.3` |
+| `image` | WebLogic Docker image. The operator requires FMW Infrastructure 12.2.1.3.0 with patch 29135930 applied. Refer to [FMW Infrastructure domains]({{< relref "/userguide/managing-fmw-domains/fmw-infra/_index.md#obtaining-the-fmw-infrastructure-docker-image" >}}) for details on how to obtain or create the image. | `container-registry.oracle.com/middleware/fmw-infrastructure:12.2.1.3` |
 | `imagePullPolicy` | WebLogic Docker image pull policy. Legal values are `IfNotPresent`, `Always`, or `Never` | `IfNotPresent` |
 | `imagePullSecretName` | Name of the Kubernetes secret to access the Docker Store to pull the WebLogic Server Docker image. The presence of the secret will be validated when this parameter is specified. |  |
 | `includeServerOutInPodLog` | Boolean indicating whether to include the server .out to the pod's stdout. | `true` |

docs-source/content/samples/simple/domains/soa-domain/_index.md

@@ -1,5 +1,5 @@
 ---
-title: "Manage domains"
+title: "Manage WebLogic domains"
 date: 2019-02-23T16:43:45-05:00
 weight: 4
 description: "Important considerations for WebLogic domains in Kubernetes."

docs-source/content/userguide/managing-domains/_index.md

@@ -26,7 +26,7 @@ The following prerequisites must be fulfilled before proceeding with the creatio
 
 Domain resources are defined using the domain resource YAML files. For each WLS domain you want to create and configure, you should create one domain resource YAML file and apply it. In the example referenced below, the sample script, `create-domain.sh`, generates a domain resource YAML file that you can use as a basis. Copy the file and override the default settings so that it matches all the WLS domain parameters that define your WLS domain.
 
-See the [WebLogic sample domain home on a persistent volume README]({{< relref "/samples/simple/domains/domain-home-on-pv/_index.md" >}}).
+See the WebLogic sample [Domain home on a persistent volume]({{< relref "/samples/simple/domains/domain-home-on-pv/_index.md" >}}) README.
 
 #### Kubernetes resources
 
@@ -77,7 +77,7 @@ Elements related to security:
 
 * `webLogicCredentialsSecret`: The name of a pre-created Kubernetes secret, in the domain resource's namespace, that holds the user name and password needed to boot WebLogic Server under the `username` and `password` fields.
 
-Elements related to domain [startup and shutdown](domain-lifecycle/startup.md):
+Elements related to domain [startup and shutdown]({{< relref "/userguide/managing-domains/domain-lifecycle/startup.md" >}}):
 
 * `serverStartPolicy`: The strategy for deciding whether to start a server. Legal values are `ADMIN_ONLY`, `NEVER`, or `IF_NEEDED`.
 * `serverStartState`: The state in which the server is to be started. Use `ADMIN` if the server should start in the admin state. Defaults to `RUNNING`.
@@ -100,7 +100,7 @@ Sub-sections related to the Administration Server, specific clusters, or specifi
 * `clusters`: Configuration for specific clusters.
 * `managedServers`: Configuration for specific Managed Servers.
 
-The elements `serverStartPolicy`, `serverStartState`, `serverPod` and `serverService` are repeated under `adminServer` and under each entry of `clusters` or `managedServers`.  The values directly under `spec` set the defaults for the entire domain.  The values under a specific entry under `clusters` set the defaults for cluster members of that cluster.  The values under `adminServer` or an entry under `managedServers` set the values for that specific server.  Values from the domain scope and values from the cluster (for cluster members) are merged with or overridden by the setting for the specific server depending on the element.  See the [startup and shutdown](domain-lifecycle/startup.md) documentation for details about `serverStartPolicy` combination.
+The elements `serverStartPolicy`, `serverStartState`, `serverPod` and `serverService` are repeated under `adminServer` and under each entry of `clusters` or `managedServers`.  The values directly under `spec` set the defaults for the entire domain.  The values under a specific entry under `clusters` set the defaults for cluster members of that cluster.  The values under `adminServer` or an entry under `managedServers` set the values for that specific server.  Values from the domain scope and values from the cluster (for cluster members) are merged with or overridden by the setting for the specific server depending on the element.  See the [startup and shutdown]({{< relref "/userguide/managing-domains/domain-lifecycle/startup.md" >}}) documentation for details about `serverStartPolicy` combination.
 
 ### Pod generation
 

docs-source/content/userguide/managing-domains/domain-resource.md

@@ -0,0 +1,9 @@
+---
+title: "Manage FMW Domains"
+date: 2019-02-23T16:43:10-05:00
+weight: 4
+draft: false
+---
+Use the operator to manage Oracle Fusion Middleware domains.
+
+{{% children style="h4" description="true" %}}

docs-source/content/userguide/managing-fmw-domains/_index.md

@@ -1,9 +1,10 @@
-+++
-title = "FMW domains"
-date = 2019-04-18T06:46:23-05:00
-weight = 5
-pre = "<b> </b>"
-+++
+---
+title: "Manage FMW Infrastructure domains"
+date: 2019-04-18T06:46:23-05:00
+weight: 1
+description: "FMW Infrastructure domains contain the Java Required Files (JRF) feature and are
+the prerequisite for upper stack products like Oracle SOA Suite."
+---
 
 #### Contents
 
@@ -25,7 +26,7 @@ the prerequisite for "upper stack" products like Oracle SOA Suite, for example.
 These domains also require a database and the use of the Repository
 Creation Utility (RCU).
 
-This section provides details about the special considerations for running
+This document provides details about the special considerations for running
 FMW Infrastructure domains with the operator.  Other than those considerations
 listed here, FMW Infrastructure domains work in the same way as WebLogic Server domains.
 The remainder of the documentation in this site applies equally to FMW