fix for comments. standardize where necessary

Author: CarolynRountree

documentation/2.0/content/userguide/tools/compare.md

@@ -297,6 +297,6 @@ Comparing the new and old models:
 
 | Parameter | Definition | Default |
 | --- | --- | --- |
-| -oracle_home | Home directory of the Oracle installation. Required if ORACLE_HOME environment variable is not set |    |
-| -output_directory | (Required) Directory in which to store the output. |    |
+| -oracle_home | Home directory of the Oracle installation. Required if ORACLE_HOME environment variable is not set. |    |
+| -output_dir | (Required) Directory in which to store the output. |    |
 | -variable_file | Variable file used for token substitution. |    |

documentation/2.0/content/userguide/tools/create.md

@@ -64,10 +64,10 @@ topology:
 | -archive_file | The path to the archive file to use.  If the -model_file argument is not specified, the model file in this archive will be used.  This can also be specified as a comma-separated list of archive files.  The overlapping contents in each archive take precedence over previous archives in the list. |    |
 | -domain_home | Required if -domain_parent is not used. The full directory and name where the domain should be created.
 | -domain_parent | Required if -domain_home is not used. The parent directory where the domain should be created. The name is the domain name in the model. |    |
-| -domain_type | The type of domain (e.g., WLS, JRF).  This controls the domain templates and template resource targeting. | WLS |
+| -domain_type | The type of domain (e.g., WLS, JRF). | WLS |
 | -java_home | The Java Home to use for the new domain. If not specified, it defaults to the value of the JAVA_HOME environment variable. |    |
-| -model_file | The location of the model file to use.  This can also be specified as a comma-separated list of model locations, where each successive model layers on top of the previous ones. |    |
-| -oracle_home | The existing Oracle Home directory for the domain. This is required unless the ORACLE_HOME environment variable is set. |    |
+| -model_file | The location of the model file.  This can also be specified as a comma-separated list of model locations, where each successive model layers on top of the previous ones. |    |
+| -oracle_home | Home directory of the Oracle WebLogic Installation. Required if ORACLE_HOME environment variable is not set.|    |
 | -opss_wallet_passphrase_env | An alternative to entering the OPSS wallet passphrase at a prompt. The value is an ENVIRONMENT VARIABLE name that WDT will use to retrieve the passphrase. |    |
 | -opss_wallet_passphrase_file | An alternative to entering the OPSS wallet passphrase at a prompt. The value is the name of a file with a string value which WDT will read to retrieve the passphrase.
 | -passphrase_env | An alternative to entering the encryption passphrase at a prompt. The value is an ENVIRONMENT VARIABLE name that WDT will use to retrieve the passphrase. |    |

documentation/2.0/content/userguide/tools/deploy.md

@@ -52,11 +52,11 @@ The Deploy Applications Tool supports the use of multiple models, as described i
 | -admin_user | The admin username used for online deploy. |    |
 | -archive_file | The path to the archive file. If the model_file argument is not used, the model file in this file will be used. This can also be specified as a comma-separated list of archive files.  The overlapping contents in each archive take precedence over previous archives in the list. |    |
 | -cancel_changes_if_restart_required | Cancel the changes if the update requires domain restart. |    |
-| -discard_current_edit | Discard all current edits before starting update. |    |
-| -domain_home | (Required). The domain home directory. |    |
-| -domain_type | The type of domain. | WLS |
+| -discard_current_edit | Discard all current domain edits before starting update. |    |
+| -domain_home | (Required). The location of the existing domain home. |    |
+| -domain_type | The type of domain.  (e.g., WLS, JRF) | WLS |
 | -model_file | The location of the model file. This can also be specified as a comma-separated list of model locations, where each successive model layers on top of the previous ones. |    |
-| -oracle_home | The location of the existing oracle home directory. Required if ORACLE_HOME environment variable is not set. |    |
+| -oracle_home | Home directory of the Oracle WebLogic Installation. Required if ORACLE_HOME environment variable is not set.|    |
 | -output_dir | If present, write restart information to this directory as restart.file, or, if cancel_changes_if_restart_required used, write non dynamic changes information to file. |    |
 | -passphrase_env | An alternative to entering the encryption passphrase at a prompt. The value is an ENVIRONMENT VARIABLE name that WDT will use to retrieve the passphrase. |    |
 | -passphrase_file | An alternative to entering the encryption passphrase at a prompt. The value is the name of a file with a string value which WDT will read to retrieve the passphrase. |    |

documentation/2.0/content/userguide/tools/discover.md

@@ -81,16 +81,16 @@ Please provide the `STDOUT` and `STDERR` log streams in the GitHub Issue. If the
 
 | Parameter | Definition | Default |
 | ---- | ---- | ---- |
-| -archive_file | The path to the archive file |    |
+| -archive_file | The path to the archive file. |    |
 | -admin_pass_env | An alternative to entering the admin password at a prompt. The value is a ENVIRONMENT VARIABLE name that WDT will use to retrieve the password. |    |
-| -admin_pass_file | An alternative to entering the admin password at a prompt. The value is a ENVIRONMENT VARIABLE name that WDT will use to retrieve the password. |    |
+| -admin_pass_file | An alternative to entering the admin password at a prompt. The value is a the name of a file that contains a password string that the tool will read to retrieve the password. |    |
 | -admin_url | The admin server URL used for online discovery. |    |
 | -admin_user | The admin user used for online discovery. |    |
-| -domain_home | (Required). The domain home directory to discover. |    |
-| -domain_type | The domain type. | WLS |
+| -domain_home | (Required). The location of the existing domain home. |    |
+| -domain_type | The type of domain.  (e.g., WLS, JRF) | WLS |
 | -java_home | Overrides the JAVA_HOME value when discovering domain values to be replaced with the java home global token. |    |
-| -model_file | Location and name to write the model file to archive. |    |
-| -oracle_home | The existing Oracle Home directory for the domain. This is required unless the ORACLE_HOME environment variable is set. |    |
+| -model_file | The path to the model file. If not present, model file will be stored in archive file. |    |
+| -oracle_home | Home directory of the Oracle WebLogic Installation. Required if ORACLE_HOME environment variable is not set. |    |
 | -output_dir | Output directory required for -target. |    |
 | -skip_archive | Do not generate an archive file. The archive_file option will be ignored. |    |
 | -target | Targeting platform - k8s, wko, vz. |    |

documentation/2.0/content/userguide/tools/encrypt.md

@@ -225,8 +225,8 @@ The variable file will now look something like the following:
 | Parameter | Definition | Default |
 | ---- | ---- | ---- |
 | -manual | Run without a model and get an encrypted value for a single password. |    |
-| -model_file | The location of a model file or a set of model files. |    |
-| -oracle_home | The existing Oracle Home directory for the domain. This is required unless the ORACLE_HOME environment variable is set.|    |
+| -model_file | The location of the model file or a set of model files. |    |
+| -oracle_home | Home directory of the Oracle WebLogic Installation. Required if ORACLE_HOME environment variable is not set. |    |
 | -passphrase_env | An alternative to entering the encryption passphrase at a prompt. The value is a ENVIRONMENT VARIABLE name that WDT will use to retrieve the passphrase. |    |
 | -passphrase_file | An alternative to entering the encryption passphrase at a prompt. The value is a the name of a file with a string value which WDT will read to retrieve the passphrase. |    |
 | -variable_file | The location and name of the property file containing the variable values for all variables used in the model(s). |    |

documentation/2.0/content/userguide/tools/kubernetes.md

@@ -132,5 +132,5 @@ The content in the `kubernetes` section is not generated when a model is discove
 | -domain_home | (Required) The domain home directory. |    |
 | -domain_resource_file | (Required) The location of the extracted domain resource file. |    |
 | -model_file | The location of the model file.  This can also be specified as a comma-separated list of model locations, where each successive model layers on top of the previous ones. |    |
-| -oracle_home | The existing Oracle Home directory for the domain. This is required unless the ORACLE_HOME environment variable is set. |    |
+| -oracle_home | Home directory of the Oracle WebLogic Installation. Required if ORACLE_HOME environment variable is not set. |    |
 | -variable_file | The location of the property file containing the values for variables used in the model. This can also be specified as a comma-separated list of property files, where each successive set of properties layers on top of the previous ones. |    |

documentation/2.0/content/userguide/tools/model_help.md

@@ -130,5 +130,5 @@ resources:
 
 | Parameter | Definition | Default |
 | ---- | ---- | ---- | 
-| -model_path | The path to the model element to be examined. The format is [^<section^>:][/^<folder^>]... |    |
-| -oracle_home | An existing Oracle Home directory. This is required unless the ORACLE_HOME environment variable is set. |    |
+| -oracle_home | Home directory of the Oracle WebLogic Installation. Required if ORACLE_HOME environment variable is not set. |    |
+| <model_path> | The path to the model element to be examined. The format is [^<section^>:][/^<folder^>]... |    |

documentation/2.0/content/userguide/tools/prepare.md

@@ -43,7 +43,7 @@ For more information about additional target environments and options, see [Targ
 | Parameter | Definition | Default |
 | ---- | ---- | ---- |
 | -model_file | (Required). Location of the model file. This can also be specified as a comma-separated list of models, where each successive model layers on top of the previous ones. |    |
-| -oracle_home | An existing Oracle home. This is required unless the ORACLE_HOME ENVIRONMENT is set' |    |
+| -oracle_home | Home directory of the Oracle WebLogic Installation. Required if ORACLE_HOME environment variable is not set. |    |
 | -output_dir | (Required) Location where to write the output files. |    |
 | -target | (Required) Name of the target configuration such as wko, vz, k8s. |    |
 | -variable_file | The location of the property file containing the values for variables used in the model. This can also be specified as a comma-separated list of property files, where each successive set of properties layers on top of the previous ones. |    |

documentation/2.0/content/userguide/tools/update.md

@@ -46,13 +46,13 @@ The Update Domain Tool supports the use of multiple models, as described in [Usi
 | -admin_pass_file | An alternative to entering the admin password at a prompt. The value is a the name of a file that contains a password string that the tool will read to retrieve the password. |    |
 | -admin_url | The admin server URL for online update. |    |
 | -admin_user | The admin username for online update. |    |
-| -archive_file | The path to the archive file to use.  If the -model_file argument is not specified, the model file in this archive will be used.  This can also be specified as a comma-separated list of archive files. The overlapping contents in each archive take precedence over previous archives in the list. |    |
+| -archive_file | The path to the archive file to use. If the -model_file argument is not specified, the model file in this archive will be used. This can also be specified as a comma-separated list of archive files. The overlapping contents in each archive take precedence over previous archives in the list. |    |
 | -cancel_changes_if_restart_required | Cancel the changes if the update requires domain restart. |   |
-| -discard_current_edit | Discard all existing edits before the update. |    |
+| -discard_current_edit | Discard all existing domain edits before the update. |    |
 | -domain_home | (Required) The location of the existing domain home. |    |
-| -domain_type | The type of domain to update. | WLS |
+| -domain_type | The type of domain.  (e.g., WLS, JRF) | WLS |
 | -model_file | The location of the model file. This can also be specified as a comma-separated list of model locations, where each successive model layers on top of the previous ones. |    |
-| -oracle_home | The existing Oracle Home directory for the domain. This is required unless the ORACLE_HOME environment variable is set. |    |
+| -oracle_home | Home directory of the Oracle WebLogic Installation. Required if ORACLE_HOME environment variable is not set. |    |
 | -passphrase_env | An alternative to entering the encryption passphrase at a prompt. The value is a ENVIRONMENT VARIABLE name that WDT will use to retrieve the passphrase. |    |
 | -passphrase_file | An alternative to entering the encryption passphrase at a prompt. The value is a the name of a file with a string value which WDT will read to retrieve the passphrase. |    |
 | -update_dir | If present, write restart information to this directory as restart.file, or if cancel_changes_if_restart_required used, write non dynamic changes information to non_dynamic_changes file. |    |

documentation/2.0/content/userguide/tools/validate.md

@@ -105,9 +105,9 @@ The Validate Model Tool supports the use of multiple models, as described in [Us
 | Parameter | Definition | Default |
 | ---- | ---- | ---- |
 | -archive_file | The path to the archive file to use.  If the archive file is not provided, validation will only validate the artifacts provided.  This can also be specified as a comma-separated list of archive files.  The overlapping contents in each archive take precedence over previous archives in the list. |    |
-| -domain_type | The type of domain. | WLS |
+| -domain_type | The type of domain.  (e.g., WLS, JRF) | WLS |
 | -model_file | The location of the model file to use.  This can also be specified as a comma-separated list of model locations, where each successive model layers on top of the previous ones. If not specified, the tool will look for the model in the archive. If the model is not found, validation will only validate the artifacts provided. |    |
-| -oracle_home | The existing Oracle Home directory for the domain. This is required unless the ORACLE_HOME environment variable is set. |    |
+| -oracle_home | Home directory of the Oracle WebLogic Installation. Required if ORACLE_HOME environment variable is not set. |    |
 | -target_mode | The target WLST mode that the tool should use to validate the model content.  The only valid values are online or offline. | offline |
-| -target_version | The target version of WebLogic Server the tool should use to validate the model content.  This version number can be different than the version being used to run the tool. If not specified, the tool will validate against the version being used to run the tool. |    |
+| -target_version | The target version of WebLogic Server the tool should use to validate the model content.  This version number can be different than the version being used to run the tool.  | Oracle home version   |
 | -variable_file | The location of the property file containing the variable values for all variables used in the model. If the variable file is not provided, validation will only validate the artifacts provided. |    |