fix app docs issue

Author: Katie Horne

changelog/1.23.0.md

@@ -15,9 +15,10 @@ There are no breaking changes in 1.23.0.
 - Terraform: Coder has released the first of a series of
   [Terraform scripts](https://github.com/cdr/enterprise-terraform) to facilitate
   one-click Coder deployment.
-- web: added support for [generic applications](../workspaces/applications.md);
-  users can provide images with custom applications, instead of only using
-  applications that have been built into the container image `PATH`.
+- web: added support for
+  [workspace applications](../workspaces/applications.md); users can provide
+  images with custom applications, instead of only using applications that have
+  been built into the container image `PATH`.
 - web: added support for DataSpell.
 - web: improved input validation for dev URLs.
 - web: added ability to get access token returned by OIDC providers on login.

workspaces/applications.md

@@ -15,51 +15,73 @@ workspace filesystem.
 If you'd like to use custom apps in Coder, you can enable this feature in the
 UI:
 
-1. In the top-right, click on your avatar and select **Feature Preview**
-1. Click **Generic applications** and select **Enable**.
+1. In the top-right, click on your avatar and select **Feature Preview**.
+1. Click **Workspace applications** and select **Enable**.
 
 ## Application specification file
 
-The application specification file allows you to define what Coder needs to
-launch the application. Within the file, you can specify the following for each
+To define custom applications, add a configuration file at
+`/coder/apps/config.yaml` to your image.
+
+The config file specifies the parameters Coder requires in order to launch the
+application. Within the file, you can specify the following for each
 application:
 
 ```yaml
 # /coder/apps/config.yaml
 
 apps:
-  # Name of application in launcher
+  # Name of application in launcher. Name may consist of alphanumeric
+  # characters, dashes, underscores. Names must begin with an alphanumeric
+  # character. Names must be unique per application. Required.
+  # Regex used "^[a-zA-Z0-9]+[a-zA-Z0-9-_ ]{0,62}$".
   - name: projector
-    # Application scheme - must be http or https
+    # Application scheme - must be http or https. Required.
     scheme: http
-    # Application port
+    # Application port. Required.
     port: 9999
-    # Working directory
-    dir: /home/coder
-    # File path to icon used in application launcher
+    # Host of the application to use when dialing. Defaults to localhost.
+    # Optional.
+    host: "localhost"
+    # Working directory for the start command. Required.
+    working-directory: /home/coder
+    # File path to icon used in application launcher. Icons should be either
+    # PNG, SVG, or JPG. Required.
     icon-path: /home/coder/goland.svg
-    # Command to start the application
+    # Command to start the application. Required.
     command: /home/coder/.local/bin/projector
-    # Array of arguments for command
+    # Array of arguments for command. Optional.
     args: ["run"]
-    # Health checks to get running application status
-    # Can use exec or http health checks to localhost
+    # Health checks to get running application status. Can use exec or http
+    # health checks to localhost. It is recommended to specify a health-check
+    # although not strictly required. If one is not supplied then an http
+    # request is sent to the application root path "/".
     health-check:
+      # Exec commands require an exit code of '0' to report healthy.
       exec:
         command: "pgrep"
         args: ["projector"]
+      # http sends a GET request to the address specified via the parameters.
+      # It expects a 200 status code to report healthy.
       http:
+        # Scheme must be "http" or "https". If not specified it inherits
+        # the application scheme. Optional.
         scheme: "http"
-        path: "/"
+        # The host to use when dialing the address. If not specified it
+        # inherits the application host. Optional.
+        host: "localhost"
+        # Port to use when dialing the application. If not specified it
+        # inherits the application port. Optional.
         port: 9999
+        # Path to use for the health check. If not specified defaults to
+        # "/". Optional.
+        path: "/healthz"
 ```
 
 **Notes**:
 
-- All top-level fields in the `config.yaml` file are required
-- You must include at least one health check. The `exec` health check looks for
-  an exit code of `0`, while the `http` health check looks for the return of
-  `HTTP 200`.
+- A health check _must_ report healthy for you to access the application.
+- If you specify both the HTTP and Exec health checks, Coder prioritizes HTTP.
 
 You can include the applications specification file in your
 [workspace image](../images/writing.md). You an also modify the file via