added arguments as a file documentation (#93)

Author: rosemarymarano

README.md

@@ -3,7 +3,7 @@
 Oracle is finding ways for organizations using WebLogic Server to run important workloads, to move those workloads into
 the cloud, and to simplify and speed up the application deployment life cycle. By adopting industry standards, such as Docker
 and Kubernetes, WebLogic now runs in a cloud neutral infrastructure.  To help simplify and automate the creation of
-Docker images for WebLogic Server, we are providing this open-source
+Docker images for WebLogic Server, we are providing this open source
 Oracle WebLogic Image Tool.  This tool let's you create a new Linux based image, with installations of a JDK and WebLogic Server,
 and optionally, configure a WebLogic domain with your applications, apply WebLogic Server patches, or update an existing
 image.
@@ -36,7 +36,7 @@ The Image Tool provides three functions within the main script:
 
 ## Quick Start
 
-Use the [Quick Start](site/quickstart.md) guide to create a Linux-based WebLogic Docker image.
+Use the [Quick Start](site/quickstart.md) guide to create a Linux based WebLogic Docker image.
 
 ## Samples
 

site/create-image-with-internet.md

@@ -1,6 +1,6 @@
 # Create an image with full Internet access
 
-The Image Tool supports creating Linux-based WebLogic Docker images, applying WebLogic patches, and creating WebLogic domains.  It can be used with or without Internet access.
+The Image Tool supports creating Linux based WebLogic Docker images, applying WebLogic patches, and creating WebLogic domains.  It can be used with or without Internet access.
 
 In this use case, the Image Tool will:
 
@@ -37,7 +37,7 @@ and save them in a directory of your choice, for example, `/home/acmeuser/wls-in
 
    Where ```--user --passwordEnv``` provides the credentials for a user who is entitled to download patches from Oracle Support.
 
- **NOTE**: You can provide the password in one of the three ways:
+ **NOTE**: You can provide the password in one of three ways:
 
  * Plain text
  * Environment variable

site/create-image.md

@@ -8,7 +8,7 @@ Usage: imagetool create [OPTIONS]
 
 | Parameter | Definition | Default |
 | --- | --- | --- |
-|`--additionalBuildCommands`| Path to a file with additional build commands. For more details, see [Additional information](#additional_information). |
+|`--additionalBuildCommands`| Path to a file with additional build commands. For more details, see [Additional information](#additional-information). |
 |`--chown` | `userid:groupid` for JDK/Middleware installs and patches.  | `oracle:oracle` |
 | `--docker` | Path to the Docker executable.  |  `docker` |
 | `--fromImage` | Docker image to use as a base image. |   |
@@ -53,6 +53,30 @@ RUN rm /some/dir/unnecessary-file
 LABEL owner="middleware team"
 ```
 
+#### Use an argument file
+
+You can save all arguments passed for the Image Tool in a file, then use the file as a parameter.
+
+For example, create a file called `build_args`:
+
+```bash
+create
+--type wls
+--version 12.2.1.3.0
+--tag wls:122130
+--user acmeuser@mycompany.com
+--httpProxyUrl http://mycompany-proxy:80
+--httpsProxyUrl http://mycompany-proxy:80
+--passwordEnv MYPWD
+
+```
+
+Use it on the command line, as follows:
+
+```bash
+imagetool @/path/to/build_args
+```
+
 
 ## Usage scenarios
 

site/quickstart.md

@@ -1,6 +1,6 @@
 # Quick Start
 
-Use this Quick Start guide to create a Linux-based WebLogic Docker image.
+Use this Quick Start guide to create a Linux based WebLogic Docker image.
 
 ## Before you begin
 
@@ -34,9 +34,10 @@ and save them in a directory of your choice, for example, `/home/acmeuser/wls-in
     ```
 
     You can verify the cache entries by:
-```bash
-imagetool cache listItems
-```
+
+    ```bash
+    imagetool cache listItems
+    ```
 
     ```bash
     Cache contents

site/update-image.md

@@ -23,7 +23,7 @@ Update WebLogic Docker image with selected patches
 ```
 | Parameter | Definition | Default |
 | --- | --- | --- |
-|`--additionalBuildCommands`| Path to a file with additional build commands. For more details, see [Additional information](#additional_information). |
+|`--additionalBuildCommands`| Path to a file with additional build commands. For more details, see [Additional information](#additional-information). |
 |`--chown` | `userid:groupid` for JDK/Middleware installs and patches.  | `oracle:oracle` |
 | `--docker` | Path to the Docker executable.  |  `docker` |
 | `--fromImage` | (Required) Docker image to use as a base image. |   |
@@ -54,7 +54,7 @@ Update WebLogic Docker image with selected patches
 ## Additional information
 This section provides additional information for command-line parameters requiring more details or clarification.
 
-#### `additionalBuildCommands`
+#### `--additionalBuildCommands`
 
 This is an advanced option that let's you provide additional commands to the Docker build step.  
 The input for this parameter is a simple text file that contains one or more of the valid sections: `before-jdk-install`, `after-jdk-install`, `before-fmw-install`, `after-fmw-install`, `before-wdt-command`, `after-wdt-command`, `final-build-commands`.
@@ -69,6 +69,31 @@ RUN rm /some/dir/unnecessary-file
 LABEL owner="middleware team"
 ```
 
+#### Use an argument file
+
+You can save all arguments passed for the Image Tool in a file, then use the file as a parameter.
+
+For example, create a file called `build_args`:
+
+```bash
+create
+--type wls
+--version 12.2.1.3.0
+--tag wls:122130
+--user acmeuser@mycompany.com
+--httpProxyUrl http://mycompany-proxy:80
+--httpsProxyUrl http://mycompany-proxy:80
+--passwordEnv MYPWD
+
+```
+
+Use it on the command line, as follows:
+
+```bash
+imagetool @/path/to/build_args
+```
+
+
 ## Usage scenarios
 
 **Note**: Use `--passwordEnv` or `--passwordFile` instead of `--password`.