minor improvements (#691)

Author: rosemarymarano

KnownIssues.md

@@ -1,4 +1,4 @@
-The following list are known issues. The issue may contain a work-around or an associated Issue number.
+The following list are known issues. The issue may contain a workaround or an associated Issue number.
 
 **ISSUE**:
    The createDomain and updateDomain tools cannot target non-JRF product resources to dynamic clusters because
@@ -18,7 +18,7 @@ The following list are known issues. The issue may contain a work-around or an a
 **ACTION**:
 
    You must contact WebLogic support to assist you with a solution for this targeting dilemma. You can perform
-   the following action as a temporary work-around to the described issue.
+   the following action as a temporary workaround to the described issue.
 
    1. Add a configured managed server to your dynamic cluster and re-run the createDomain or updateDomain tool.
       The dynamic cluster becomes a "mixed" cluster once the managed server is added. When the WDT tool targets the
@@ -44,21 +44,20 @@ The following list are known issues. The issue may contain a work-around or an a
 
 **ACTION**:
    Run RCU before executing createDomain for JRF domains
-   
+
 **ISSUE**:
    The discoverDomain or createDomain tool cannot handle object name with slashes and finished with  
    warnings.  For example:
-   
-    2. WLSDPLY-06140: Unable to cd to the expected path /SelfTuning/NO_NAME_0/WorkManager/wm/SOAWorkManager 
-    constructed from location context model_folders = ['SelfTuning', 'WorkManager'],  'name_tokens' = 
-    {'SELFTUNING': 'NO_NAME_0','DOMAIN': 'basesoa','WORKMANAGER': 'wm/SOAWorkManager'}; the current folder and 
-    its sub-folders cannot be discovered : wlst.cd(/SelfTuning/NO_NAME_0/WorkManager/wm/SOAWorkManager) in 
+
+    2. WLSDPLY-06140: Unable to cd to the expected path /SelfTuning/NO_NAME_0/WorkManager/wm/SOAWorkManager
+    constructed from location context model_folders = ['SelfTuning', 'WorkManager'],  'name_tokens' =
+    {'SELFTUNING': 'NO_NAME_0','DOMAIN': 'basesoa','WORKMANAGER': 'wm/SOAWorkManager'}; the current folder and
+    its sub-folders cannot be discovered : wlst.cd(/SelfTuning/NO_NAME_0/WorkManager/wm/SOAWorkManager) in
     offline mode failed: com.oracle.cie.domain.script.ScriptException: No such element WorkManager named wm
 
-   The reason for this warning is because of the slash(es) in the object name. In this case the object name is 
+   The reason for this warning is because of the slash(es) in the object name. In this case the object name is
    wm/SOAWorkManager
-   
+
 **ACTION**:
-   Contact Oracle Support to obtain the patch for the bug number 25790276 for your weblogic version 
+   Contact Oracle Support to obtain the patch for the bug number 25790276 for your weblogic version
    before running the tool.
-      

README.md

@@ -26,7 +26,9 @@ As new use cases are discovered, new tools will likely be added to cover those o
 The Oracle WebLogic Server Deploy Tooling project repository is located at [`https://github.com/oracle/weblogic-deploy-tooling`](https://github.com/oracle/weblogic-deploy-tooling).  Binary distributions of the `weblogic-deploy.zip` installer can be downloaded from the [GitHub Releases page](https://github.com/oracle/weblogic-deploy-tooling/releases).  To install the software, simply unzip the `weblogic-deploy.zip` installer on a machine that has the desired versions of WebLogic Server installed.  After being unzipped, the software is ready to use, just set the `JAVA_HOME` environment variable to point to a Java 7 or higher JDK  and the shell scripts are ready to run.
 
 
-## [Supported WLS Versions](site/wls_versions.md)
+## Supported WLS Versions
+
+For the supported WebLogic Server and JDK versions required to run WebLogic Server Deploy Tooling, see [Supported WLS Versions](site/wls_versions.md).
 
 
 ## Concepts
@@ -36,6 +38,10 @@ The Oracle WebLogic Server Deploy Tooling project repository is located at [`htt
 - [Model Use Cases](site/use_cases.md)
 - [Tool Configuration](site/tool_configuration.md)
 
-## [Developer Guide](site/developer/developer_guide.md)
+## Developer Guide
+
+For information for developers, see the [Developer Guide](site/developer/developer_guide.md).
+
+## Known Issues
 
-## [Known Issues](KnownIssues.md)
+See the following list of [Known Issues](KnownIssues.md) and workarounds.