doc updates (#78)

Author: rosemarymarano

documentation/staging/content/concepts/_index.md

@@ -30,7 +30,7 @@ desktop application.  It uses native operating system features, such as:
   have the application start and open the selected project.
 - Recent files integration - As you work with `.wktproj` files, the application adds those files to the OS-maintained
   list of recently used files.  This causes these files to show up in OS-specific locations to provide shortcuts for
-  opening the file with the application.  For example, on MacOS, right-clicking on the application icon in the dock will
+  opening the file with the application.  For example, on macOS, right-clicking on the application icon in the dock will
   display the recently used `.wktproj` files and selecting one will open an application window and load the contents
   of the `.wktproj` file.
 
@@ -76,8 +76,8 @@ examples are:
 
 {{% notice note %}}
 On Windows and Linux platforms, this tends to be the user's environment that they have configured to be used when
-they log in. On MacOS, native applications do not inherit the user's login environment.  Instead, the application
-inherits the environment configured by the `launchd` daemon process.  If you are running on MacOS, then you should keep this in mind
+they log in. On macOS, native applications do not inherit the user's login environment.  Instead, the application
+inherits the environment configured by the `launchd` daemon process.  If you are running on macOS, then you should keep this in mind
 when the application doesn't behave as you expect.
 {{% /notice %}}
 

documentation/staging/content/developer/_index.md

@@ -27,7 +27,7 @@ The WebLogic Kubernetes Toolkit UI is a desktop application designed to help Web
    git config --global user.email "<your-oracle-email-address>"
    git config --global core.ignoreCase false
    ```
-   **This last command is critical if you are developing on either Windows or MacOS.  Yes, the MacOS file system
+   **This last command is critical if you are developing on either Windows or macOS.  Yes, the macOS file system
    is, by default, case-insensitive!**
 
 5. Clone the git repository on GitHub at [https://github.com/oracle/weblogic-toolkit-ui](https://github.com/oracle/weblogic-toolkit-ui).
@@ -36,7 +36,7 @@ The WebLogic Kubernetes Toolkit UI is a desktop application designed to help Web
 8. Open a command line in the `weblogic-toolkit-ui/webui` directory and run `npm start`.
 9. After the server from the previous step is fully running, open a command line in the `weblogic-toolkit-ui/electron` directory and run `npm start`.
 
-### Building a Windows or MacOS installer
+### Building a Windows or macOS installer
 0. Set up your development environment and verify that the application is working properly from it.
 1. Open a command line in the `weblogic-toolkit-ui/electron` directory and run `npm run build`.
 2. Find the executable and installer(s) in the `weblogic-toolkit-ui/dist` directory.

documentation/staging/content/navigate/image.md

@@ -115,7 +115,8 @@ latest capabilities, many of which are exposed by this application.  As such, us
 recommended.
 
 {{% notice note %}} For "Model in Image" or "Domain in Image" [domain locations]({{< relref "/navigate/project-settings#choosing-a-domain-location" >}}),
-when building your primary or auxiliary image, we highly recommend using WDT 2.0 to take advantage of enhanced capabilities that reduce the chance of deploy-time errors created due to a bad model.    
+when building your primary or auxiliary image, Oracle strongly recommends using [WDT 2.0](https://github.com/oracle/weblogic-deploy-tooling/releases).
+Certain WKT UI actions, such as `Prepare Model`, may rewrite the model into a format that earlier WDT versions cannot parse.    
 {{% /notice %}}
 
 

documentation/staging/content/navigate/kubernetes/k8s-client-config.md

@@ -68,18 +68,6 @@ To learn more about this feature, consult the documentation available at:
 https://kubernetes.io/docs/reference/access-authn-authz/authentication/#client-go-credential-plugins.
 ```
 
-When running the application on Windows or Linux, add the appropriate directory to the `PATH` environment variable and make sure to
-run the application with that environment.  On MacOS, things are a bit more complicated.
-
-When running the WKT UI application on MacOS, the application inherits the environment of a daemon process called `launchd` instead
-of your environment.  By default, the `launchd` environment contains only a few core directories on the `PATH`
-(that is, `/usr/bin`, `/bin`, `/usr/sbin`, and `/sbin`).  This will cause `kubectl` invocations requiring access to one of
-the cloud providers' command-line tooling to fail if the tool is not found in one of those locations.  While it is
-possible for an administrative user to change the environment that `launchd` uses to address this issue, the application
-provides the `Extra Kubernetes Client Path Directories` field to explicitly add the directory where the cloud providers'
-command-line tooling is installed, to the `PATH` that the application uses to invoke `kubectl`.  Note that this field
-is only visible when running the application on MacOS.
-
 #### Verify Connectivity
 To verify the application configuration for connecting to the specified Kubernetes cluster,
 use the `Verify Connectivity` button on the `Client Configuration` page or

documentation/staging/content/navigate/model.md

@@ -13,6 +13,7 @@ weight: 2
     - [Model Editor](#model-editor)
     - [Variables Editor](#variables-editor)
     - [Archive Editor](#archive-editor)
+- [Validate Model](#validate-model)
 - [Prepare Model](#prepare-model)
 
 
@@ -133,6 +134,12 @@ appDeployments:
 To remove content from the archive file, select the content to remove in the archive editor pane and click the minus (`-`)
 button in the archive editor title bar.  _Don't forget to remove any reference to this content from the model file._
 
+#### Validate Model
+`Validate Model` invokes the WDT [Validate Model Tool](https://oracle.github.io/weblogic-deploy-tooling/userguide/tools/validate/),
+which validates that the model and its related artifacts are well-formed and provides help on the valid attributes and subfolders
+for a particular model location. This action is available by using the `Validate Model` button on the `Model` page and by selecting
+`Go` > `Validate Model Files`.
+
 #### Prepare Model
 `Prepare Model` invokes the WDT [Prepare Model Tool](https://oracle.github.io/weblogic-deploy-tooling/userguide/tools/prepare/)
 to modify the model to work in a Kubernetes cluster with WebLogic Kubernetes Operator or Verrazzano installed.  This

documentation/staging/content/navigate/project-settings.md

@@ -14,6 +14,22 @@ input for the project on:
 - [JDK and WebLogic Server Installation Directories](#choosing-the-java-and-oracle-installation-directories)
 - [Image Build Tool Type and Executable Location](#choosing-the-image-build-tool)
 
+When running the WKT UI application on Windows or Linux, the application inherits its environment from the user. For example,
+adding a directory to the PATH used by the application is just a matter of changing your
+PATH environment variable and restarting the application. On macOS, things are a bit more complicated.
+
+When running the application on macOS, the application inherits the environment of a daemon process called `launchd` instead
+of your environment.  By default, the `launchd` environment contains only a few core directories on the `PATH`
+(that is, `/usr/bin`, `/bin`, `/usr/sbin`, and `/sbin`).  This will cause `kubectl` invocations requiring access to one of
+the cloud providers' command-line tooling to fail if the tool is not found in one of those locations.  While it is
+possible for an administrative user to change the environment that `launchd` uses to address this issue, the WKT UI application
+provides the `Extra Path Directories` field to explicitly add the directory where the cloud providers'
+command-line tooling is installed, to the `PATH` that the application uses to invoke `kubectl`. Also, use the
+`Extra Environment Variable Names/Extra Environment Variable Values` fields to define extra environment variables as
+needed. Note that this extra environment configuration is used _only_ when invoking Docker/Podman, kubectl, and Helm.
+This section is visible only when running the application on macOS.
+
+
 #### Choosing a Credential Storage Scheme
 The WKT UI application can securely store credentials for your project or not store them at all.  The three choices
 are:
@@ -22,7 +38,7 @@ are:
 - Store Encrypted Credentials in the WKT Project File
 - Not Store Credentials
 
-If you choose `Store in Native OS Credential Store`, then you will be using the Windows Credential Manager, the MacOS Keychain,
+If you choose `Store in Native OS Credential Store`, then you will be using the Windows Credential Manager, the macOS Keychain,
 or the Linux `libsecret` library's credential store.  These credential stores offer a well-known, secure mechanism for
 storing credentials that most users already understand.  The only downside to this scheme is that the credentials are
 stored only on the local machine.  Anyone trying to share their project with others users will have to have the other users
@@ -32,7 +48,7 @@ re-enter the credentials so that they get saved to their local machine's credent
 The WKT UI application can require storing a dozen or more credentials, depending on your WebLogic Server
 domain configuration. Upon first access by the WKT UI to load credentials from the credential store, the OS will prompt
 whether you want to allow the application access to each credential, prompting you once for each credential.  This
-can get annoying, but on some platforms (for example, MacOS), you have the option of telling the OS to always allow access to
+can get annoying, but on some platforms (for example, macOS), you have the option of telling the OS to always allow access to
 the credential by the WKT UI application.
 {{% /notice %}}
 

documentation/staging/content/release notes/_index.md

@@ -9,13 +9,15 @@ pre = "<b> </b>"
 
 - For "Model in Image" domains, added the ability to configure, push, and use an auxiliary image.
 - Added these actions:
+   - Validate WDT model files
+   - Create and push an auxiliary image
    - Update and uninstall the WebLogic Kubernetes Operator
-   - Uninstall the ingress controller
    - Undeploy the WebLogic domain
+   - Uninstall the ingress controller
 
 ### Known Issues
 
-- When running the WKT UI application on Windows, the image builder tool (docker or podman) also must be directly executable in Windows.  For example, there is currently no support for running the WKT UI application in Windows and running podman under the Windows Subsystem for Linux (WSL2).  However, running Docker Desktop for Windows with a WSL2 backend _is_ fully supported because the `docker` command is executable directly in Windows (without having to call WSL2). If you need to use podman on Windows, then refer to the podman blog entries at https://podman.io/blogs/2021/09/06/podman-on-macs.html and https://podman.io/blogs/2020/09/02/running_windows_or_mac.html for more information about downloading, installing, and configuring the Windows Remote Client.
+- When running the WKT UI application on Windows, the image builder tool (Docker or Podman) also must be directly executable in Windows.  For example, there is currently no support for running the WKT UI application in Windows and running Podman under the Windows Subsystem for Linux (WSL2).  However, running Docker Desktop for Windows with a WSL2 backend _is_ fully supported because the `docker` command is executable directly in Windows (without having to call WSL2). If you need to use Podman on Windows, then refer to the Podman blog entries at https://podman.io/blogs/2021/09/06/podman-on-macs.html and https://podman.io/blogs/2020/09/02/running_windows_or_mac.html for more information about downloading, installing, and configuring the Windows Remote Client.
 
 - On Linux, the application depends on libGL being installed.  libGL is not currently listed in the dependencies list for the `rpm` (or `deb`) installers.  Therefore, you will need to install libGL using your package manager.  For example:
   ```
@@ -25,5 +27,3 @@ pre = "<b> </b>"
 - When trying to run the application on a Linux machine and display it on a Windows machine, do not use the Xming X server.  There appears to be a bug (presumably with their OpenGL support) that prevents applications using Electron 13.x or later from working (for example, Microsoft VS Code doesn't work either).
 
 - The application is limited to working with archive files whose size is less than 2 GB.
-
-- On MacOS, after editing a model in the Model Code View's model editor pane, you must click outside the editor pane prior to using the Menu to save or perform other actions that need the latest model content.  This is due to Electron bug [31915](https://github.com/electron/electron/issues/31915) that fails to generate the proper events when the Menu is selected on MacOS.

documentation/staging/content/setup/install.md

@@ -28,7 +28,7 @@ Alternatively, you can download the `AppImage` file, copy it to your local file
 
 - Use your file manager, right click on the file, edit the properties, and change the permissions to  make it executable.
 
-If you download and run the `AppImage` file, you get the added benefits of 1.) Not requiring an installation or root access and 2.) Being able to participate in the auto-update functionality, like MacOS and Windows.
+If you download and run the `AppImage` file, you get the added benefits of 1.) Not requiring an installation or root access and 2.) Being able to participate in the auto-update functionality, like macOS and Windows.
 
 #### Helpful Hints
 
@@ -66,7 +66,7 @@ Upon application startup, if a more recent version exists, an Application Update
 - `Install Now`
 - `Install on Exit`
     - Downloads the application and installs it after you exit.
-    - Not available on MacOS.
+    - Not available on macOS.
 - `Ignore Update`
 
 At any time, you can check for application updates using `Help > Check for WKT UI Updates`.