first pass at updating the images doc (#102)

* first pass at updating the images doc

* add x-ref to image section

* add graphics and short code

* update graphics files

* incorporate edit from Robert

Author: rosemarymarano

documentation/1.1/content/navigate/image.md

@@ -24,20 +24,26 @@ in a Kubernetes environment using the [WebLogic Image Tool](https://oracle.githu
 
 ### Design View
 The `Design View` helps you specify the necessary data needed to run the WebLogic Image Tool to build an image for
-running the WebLogic domain with all resources configured and applications deployed. The `Design View` page is divided into `Primary Image` and `Auxiliary Image` pages.
-Auxiliary images are available for the "Model in Image" [domain location]({{< relref "/navigate/project-settings#choosing-a-domain-location" >}}) _only_.
+running the WebLogic domain.
 
-- `Primary Image` - The image containing the Oracle Fusion Middleware software. It is used as the basis of all containers that run WebLogic Servers for the domain.
-- `Auxiliary Image` - The image that supplies the WebLogic Deploy Tooling software and the model files. At runtime, the auxiliary image's content is merged with the primary image's content.
+Use the `Design View` page to specify whether to create a new or use an existing (the default) `Primary Image` and
+whether or not (the default) to use an `Auxiliary Image` (an existing one or create a new one).
+**Note** that auxiliary images are available for the "Model in Image" [domain location]({{< relref "/navigate/project-settings#choosing-a-domain-location" >}}) _only_.
 
-The primary image is the one used for running the domain and the auxiliary contains the data that defines the domain. One primary image can be
+
+- **Primary Image** - The image containing the Oracle Fusion Middleware software. It is used as the basis of all containers that run WebLogic Servers for the domain.
+- **Auxiliary Image** - The image that supplies the WebLogic Deploy Tooling software and the model files. At runtime, the auxiliary image's content is merged with the primary image's content.
+
+
+{{< himg "Primary image diagram" "images/primary-image.png" "Auxiliary image diagram" "images/auxiliary-image.png" >}}
+
+The primary image is the one used for running the domain and the auxiliary image contains the data that defines the domain. One primary image can be
 reused for hundreds of domains whereas an auxiliary image is domain-specific. When using auxiliary images,
 the primary image contains the OS, JDK, and FMW software installations; the auxiliary image supplies the specifics for a single domain.
 
-Use the `Design View` page to create a new or use an existing (the default) `Primary Image` and,
-for "Model in Image" domains only, create a new (the default) or use an existing `Auxiliary Image`.
-The `Design View` page has the following basic panes and a few advanced panes.
-Note that _not all_ the fields described for the `Primary Image` are relevant for an `Auxiliary Image`. The exceptions are noted.
+If you select to create a new primary image, you'll see the following basic panes and a few advanced panes on the `Primary Image` Design View page.
+If you select to create a new auxiliary image, you must select the `Auxiliary Image` Design View page, to configure it.
+Note that _not all_ the fields described in the following sections for the `Primary Image`, are relevant for an `Auxiliary Image`. The exceptions are noted.
 
 - [Target Image Name and Registry Credentials](#target-image-name-and-registry-credentials)
 - [Base Image to Use](#base-image-to-use)

documentation/1.1/content/navigate/kubernetes/k8s-weblogic-domain.md

@@ -80,7 +80,9 @@ The following sections describe the other panes that support configuring the gen
 - [Domain-Wide Server Settings](#domain-wide-server-settings)
 
 #### Primary Image to Use for the Domain
-This pane focuses on the container primary image to use to run the WebLogic Server domain in a container.   
+This pane focuses on the container primary image to use to run the WebLogic Server domain in a container. If you select `Create a New Primary Image`,
+then click `Go To Create Primary Image Page` to configure the image. For detailed information, see the [Image]({{< relref "/navigate/image.md" >}}) section.
+
 - When using either "Model in Image" or "Domain in Image" [domain location]({{< relref "/navigate/project-settings#choosing-a-domain-location" >}}), the `Primary Image Tag` field is read-only; its value is set using the
 `Image Tag` field in the `Image` section.  
 - In the case of "Domain in PV", the `Image Tag` field is not read-only and _is_
@@ -103,6 +105,10 @@ whether to use an existing image pull secret or create a new one.  Specify the i
 
 #### Auxiliary Image to Use for the Domain
 
+Under `Auxiliary Image Configuration`, use the radio buttons to specify whether or not to use an Auxiliary Image (an existing one) or create a new one (the default).
+If you select `Create a New Auxiliary Image`, then click `Go To Create Auxiliary Image Page` to configure the image. For detailed information,
+see the [Image]({{< relref "/navigate/image.md" >}}) section.
+
 For "Model in Image" domains only, this pane focuses on the container auxiliary image to use for the domain.
 - The `Auxiliary Image Tag` field is read-only; its value is set using the
 `Auxiliary Image Tag` field in the `Auxiliary Image` page of the `Image` section.

documentation/1.1/layouts/shortcodes/img.html

@@ -0,0 +1 @@
+<img src="{{ .Get 1 | absURL }}" alt="{{ .Get 0 }}">