clarification of KIE_SERVER_CONTAINER_DEPLOYMENT (#53)

* clarification of KIE_SERVER_CONTAINER_DEPLOYMENT

* SME review

* fix lost endif

* peer review

* small style fixes

* external repo

* removed two colons

doc-content/enterprise-only/openshift/template-deploy-mandatory-proc.adoc

@@ -128,17 +128,30 @@ into this repository.
 ** *Maven repository password* (`MAVEN_REPO_PASSWORD`): The password for the Maven repository.
 endif::params_mandatory_maven[]
 ifdef::params_kieserver_container_deployment[]
-** *KIE Server Container Deployment* (`KIE_SERVER_CONTAINER_DEPLOYMENT`): The identifying information of the decision services (KJAR files) that the deployment must pull from the Maven repository. The format is: `<containerId>=<groupId>:<artifactId>:<version>`. You can provide two or more KJAR files using the `|` separator, as illustrated in the following example: `containerId=groupId:artifactId:version|c2=g2:a2:v2`.
+** *KIE Server Container Deployment* (`KIE_SERVER_CONTAINER_DEPLOYMENT`): The identifying information of the decision services (KJAR files) that the deployment must pull from the Maven repository. The format is `<containerId>=<groupId>:<artifactId>:<version>`. You can provide two or more KJAR files using the `|` separator, as illustrated in the following example: 
++
+[source]
+----
+containerId=groupId:artifactId:version|c2=g2:a2:v2 
+----
++
 endif::params_kieserver_container_deployment[]
 ifdef::params_kieserver_s2i[]
-** *KIE Server Container Deployment* (`KIE_SERVER_CONTAINER_DEPLOYMENT`): The identifying information of the decision service (KJAR file) that is built from your source. The format is: `<containerId>=<groupId>:<artifactId>:<version>`. You can provide two or more KJAR files using the `|` separator, as illustrated in the following example: `containerId=groupId:artifactId:version|c2=g2:a2:v2`. The Maven build process must produce all these files from the source in the Git repository.
+** *KIE Server Container Deployment* (`KIE_SERVER_CONTAINER_DEPLOYMENT`): The identifying information of the decision service (KJAR file) that the deployment must pull from the local or external repository after building your source. The format is `<containerId>=<groupId>:<artifactId>:<version>`. You can provide two or more KJAR files using the `|` separator, as illustrated in the following example:
++
+[source]
+----
+containerId=groupId:artifactId:version|c2=g2:a2:v2 
+----
++ 
+If the `KIE_SERVER_CONTAINER_DEPLOYMENT` value is not defined, the server discovers the group ID, artifact ID, and version of the artifacts by inspecting the `pom.xml` file of your project and uses the artifact ID as the container ID. To avoid duplicate container IDs, the artifact ID must be unique for each artifact built or used in your project.
 ** *Git Repository URL* (`SOURCE_REPOSITORY_URL`): The URL for the Git repository that contains the source for your services.
 ** *Git Reference* (`SOURCE_REPOSITORY_REF`): The branch in the Git repository.
 ** *Context Directory* (`CONTEXT_DIR`): The path to the source within the project downloaded from the Git repository.
 ** *Artifact Directory* (`ARTIFACT_DIR`): The path within the project that contains the required binary files (KJAR files and any other necessary files) after a successful Maven build. Normally this directory is the target directory of the build. However, you can provide prebuilt binaries in this directory in the Git repository.
 endif::params_kieserver_s2i[]
 ifdef::mode_production_template[]
-** *KIE Server Mode* (`KIE_SERVER_MODE`): In the `{mode_production_template}` {mode_template_word} the default value is `PRODUCTION`; in this mode, you cannot deploy `SNAPSHOT` versions of KJAR artifacts on the {KIE_SERVER} and cannot change versions of an artifact in an existing container. (To deploy a new version with `PRODUCTION` mode, you can create a new container on the same {KIE_SERVER}). To deploy `SNAPSHOT` versions or to change versions of an artifact in an existing container, set this parameter to `DEVELOPMENT`.
+** *KIE Server Mode* (`KIE_SERVER_MODE`): In the `{mode_production_template}` {mode_template_word} the default value is `PRODUCTION`. In `PRODUCTION` mode, you cannot deploy `SNAPSHOT` versions of KJAR artifacts on the {KIE_SERVER} and cannot change versions of an artifact in an existing container. To deploy a new version with `PRODUCTION` mode, create a new container on the same {KIE_SERVER}. To deploy `SNAPSHOT` versions or to change versions of an artifact in an existing container, set this parameter to `DEVELOPMENT`.
 endif::mode_production_template[]
 ** *ImageStream Namespace* (`IMAGE_STREAM_NAMESPACE`): The namespace where the image streams are available. If the image streams were already available in your OpenShift environment (see <<imagestreams-file-install-proc>>), the namespace is `openshift`. If you have installed the image streams file, the namespace is the name of the OpenShift project.
 +