Improve readme and inputs comments for custom create domain scripts

Signed-off-by: doxiao <[email protected]>

Author: doxiao

kubernetes/samples/scripts/create-weblogic-domain/domain-home-on-pv/README.md

@@ -74,9 +74,9 @@ The following parameters can be provided in the inputs file.
 | `adminServerName` | Name of the Administration Server. | `admin-server` |
 | `clusterName` | Name of the WebLogic cluster instance to generate for the domain. | `cluster-1` |
 | `configuredManagedServerCount` | Number of Managed Server instances to generate for the domain. | `5` |
-| `createDomainFilesDir` | Directory to get all the create domain scripts and supporting files, including the script that is specified by the `createDomainScriptName` property. By default, this directory is set to the relative path `wlst`, and the create script will use the built-in WLST offline scripts in the `wlst` directory to create the WebLogic domain. It can also be set to the relative path `wdt`, and then the built-in WDT scripts will be used instead. An absolute path is also supported to point to an arbitrary directory in the file system. | `wlst` |
-| `createDomainScriptsMountPath` | Mount path of the directory where the create domain scripts are located inside the pod. | `/u01/weblogic` |
-| `createDomainScriptName` | Script that creates the domain. | `create-domain-job.sh` |
+| `createDomainFilesDir` | Directory on the host machine to locate all the files to create a WebLogic domain, including the script that is specified in the `createDomainScriptName` property. By default, this directory is set to the relative path `wlst`, and the create script will use the built-in WLST offline scripts in the `wlst` directory to create the WebLogic domain. It can also be set to the relative path `wdt`, and then the built-in WDT scripts will be used instead. An absolute path is also supported to point to an arbitrary directory in the file system. The built-in scripts can be replaced by the user-provided scripts or model files as long as those files are in the specified directory. Files in this directory are put into a Kubernetes config map, which in turn is mounted to the `createDomainScriptsMountPath`, so that the Kubernetes pod can use the scripts and supporting files to creates a domain home. | `wlst` |
+| `createDomainScriptsMountPath` | Mount path where the create domain scripts are located inside a pod. The `create-domain.sh` script creates a Kubernetes job to run the script (specified in the `createDomainScriptName` property) in a Kubernetes pod to create a domain home. Files in the `createDomainFilesDir` directory are mounted to this location in the pod, so that the Kubernetes pod can use the scripts and supporting files to creates a domain home. | `/u01/weblogic` |
+| `createDomainScriptName` | Script that the create domain script uses to create a WebLogic domain. The `create-domain.sh` script creates a Kubernetes job to run this script to create a domain home. The script is located in the in-pod directory that is specified in the `createDomainScriptsMountPath` property. If you need to provide your own scripts, instead of using the built-it scripts, to create the domain home, you need to set here the name of the script that you want the create domain job to run. | `create-domain-job.sh` |
 | `domainHome` | Home directory of the WebLogic domain. If not specified, the value is derived from the `domainUID` as `/shared/domains/<domainUID>`. | `/shared/domains/domain1` |
 | `domainPVMountPath` | Mount path of the domain persistent volume. | `/shared` |
 | `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` |

kubernetes/samples/scripts/create-weblogic-domain/domain-home-on-pv/create-domain-inputs.yaml

@@ -1,4 +1,4 @@
-# Copyright 2018, Oracle Corporation and/or its affiliates.  All rights reserved.
+# Copyright 2018,2019, Oracle Corporation and/or its affiliates.  All rights reserved.
 # Licensed under the Universal Permissive License v 1.0 as shown at http://oss.oracle.com/licenses/upl.
 
 # The version of this inputs file.  Do not modify.
@@ -97,14 +97,37 @@ persistentVolumeClaimName: domain1-weblogic-sample-pvc
 # Mount path of the domain persistent volume. 
 domainPVMountPath: /shared
 
-# Mount path of the directory where the create domain scripts are located inside the pod
+# Mount path where the create domain scripts are located inside a pod
+#
+# The `create-domain.sh` script creates a Kubernetes job to run the script (specified in the
+# `createDomainScriptName` property) in a Kubernetes pod to create a WebLogic home. Files
+# in the `createDomainFilesDir` directory are mounted to this location in the pod, so that
+# a Kubernetes pod can use the scripts and supporting files to creates a domain home.
 createDomainScriptsMountPath: /u01/weblogic
 
-# Script that creates the domain. 
+# Script that the create domain script uses to create a WebLogic domain
+#
+# The `create-domain.sh` script creates a Kubernetes job to run this script to create a
+# domain home. The script is located in the in-pod directory that is specified in the
+# `createDomainScriptsMountPath` property.
+#
+# If you need to provide your own scripts, instead of using the built-it scripts, to create
+# the domain home, you need to set here the name of the script that you want the create
+# domain job to run.
 createDomainScriptName: create-domain-job.sh
 
-# Directory to get all the create domain scripts and supporting files, including 
-# the script that is specified by the createDomainScriptName property.
-# The default is the "wlst" subdirectory under the directory where the 
-# create-domain.sh script is located.
+# Directory on the host machine to locate all the files to create a WebLogic domain
+# It contains the script that is specified in the `createDomainScriptName` property.
+#
+# By default, this directory is set to the relative path `wlst`, and the create script will
+# use the built-in WLST offline scripts in the `wlst` directory to create the WebLogic domain.
+# It can also be set to the relative path `wdt`, and then the built-in WDT scripts will be
+# used instead.
+# 
+# An absolute path is also supported to point to an arbitrary directory in the file system.
+#
+# The built-in scripts can be replaced by the user-provided scripts or model files as long
+# as those files are in the specified directory. Files in this directory are put into a
+# Kubernetes config map, which in turn is mounted to the `createDomainScriptsMountPath`,
+# so that the Kubernetes pod can use the scripts and supporting files to creates a domain home.
 createDomainFilesDir: wlst