Jobspec documentation for UI block

website/content/docs/job-specification/ui.mdx

@@ -0,0 +1,47 @@
+---
+layout: docs
+page_title: ui Block - Job Specification
+description: |-
+  The "ui" block allows lets users add description and helpful links to their
+  job page in the Nomad Web UI.
+---
+
+# `ui` Block
+
+<Placement
+  groups={[
+    ['job', 'ui'],
+  ]}
+/>
+
+The `ui` block provides options to modify the presentation of the Job index page
+in the Web UI. When specified, a description and any number of links will be
+added to the top of the job page in question.
+
+The following will provide the Web UI with a job description and a pair of links:
+
+## `ui` Parameters
+
+- `description` `(string: "")` - The markdown-enabled description of the job
+- `link` `(map<string|string>: nil)` - A link that should show up in the header
+  of the job index page in the Web UI. A job can have any number of links, and
+  they must contain both a string `label` and `url`.
+
+## `ui` Example
+
+```hcl
+job "docs" {
+  ui {
+    description = "A job that uses **Nomad Variables**"
+    link {
+      label = "Learn more about Nomad"
+      url = "https://developer.hashicorp.com/nomad"
+    }
+    link {
+      label = "Nomad on Github"
+      url = "https://github.com/hashicorp/nomad"
+    }
+  }
+  # ...
+}
+```

website/data/docs-nav-data.json

@@ -1807,6 +1807,10 @@
         "title": "transparent_proxy",
         "path": "job-specification/transparent_proxy"
       },
+      {
+        "title": "ui",
+        "path": "job-specification/ui"
+      },
       {
         "title": "update",
         "path": "job-specification/update"