docs: add Quota specification page

and update some related pages

website/content/docs/enterprise/index.mdx

@@ -154,9 +154,10 @@ thorough overview.
 
 Resource Quotas enable an operator to limit resource consumption across teams
 or projects to reduce waste and align budgets. In Nomad Enterprise, operators
-can define quota specifications and apply them to namespaces. When a quota is
-attached to a namespace, the jobs within the namespace may not consume more
-resources than the quota specification allows.
+can define [quota specifications](/nomad/docs/other-specifications/quota)
+and apply them to namespaces. When a quota is attached to a namespace,
+the jobs within the namespace may not consume more resources than the quota
+specification allows.
 
 This allows operators to partition a shared cluster and ensure that no single
 actor can consume the whole resources of the cluster.

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

@@ -133,7 +133,7 @@ oversubscription support.
 
 Memory oversubscription is opt-in. Nomad operators can enable [Memory
 Oversubscription in the scheduler configuration][api_sched_config]. Enterprise
-customers can use [Resource Quotas][tutorial_quota] to limit the memory
+customers can use [Resource Quotas][quota_spec] to limit the memory
 oversubscription and enable or disable memory oversubscription per [node
 pool][np_sched_config].
 
@@ -157,6 +157,6 @@ resource utilization and considering the following suggestions:
 [docker_cpu]: /nomad/docs/drivers/docker#cpu
 [exec_cpu]: /nomad/docs/drivers/exec#cpu
 [np_sched_config]: /nomad/docs/other-specifications/node-pool#memory_oversubscription_enabled
-[tutorial_quota]: /nomad/tutorials/governance-and-policy/quotas
+[quota_spec]: /nomad/docs/other-specifications/quota
 [numa]: /nomad/docs/job-specification/numa 'Nomad NUMA Job Specification'
 [`secrets/`]: /nomad/docs/runtime/environment#secrets

website/content/docs/other-specifications/index.mdx

@@ -6,12 +6,13 @@ description: Learn about other specifications used in Nomad.
 
 # Other Specifications
 
-In addition to [jobs][job_spec] there are other objects that can be specified
-in Nomad.
+In addition to
+[Jobs](/nomad/docs/job-specification),
+there are other objects that can be specified in Nomad:
 
-- [ACL Policy][acl_policy_spec]
-- [Volume][volume_spec]
-
-[job_spec]: /nomad/docs/job-specification
-[acl_policy_spec]: /nomad/docs/other-specifications/acl-policy
-[volume_spec]: /nomad/docs/other-specifications/volume
+- [ACL Policy](/nomad/docs/other-specifications/acl-policy)
+- [Namespace](/nomad/docs/other-specifications/namespace)
+- [Node Pool](/nomad/docs/other-specifications/node-pool)
+- [Quota](/nomad/docs/other-specifications/quota)
+- [Variable](/nomad/docs/other-specifications/variables)
+- [Volume](/nomad/docs/other-specifications/volume)

website/content/docs/other-specifications/quota.mdx

@@ -0,0 +1,88 @@
+---
+layout: docs
+page_title: Nomad Quota Specification
+description: Learn about Nomad's Resource Quota specification.
+---
+
+# Nomad Quota Specification
+
+<EnterpriseAlert>
+Resource Quotas are only available with Nomad Enterprise.
+</EnterpriseAlert>
+
+[Resource Quotas](/nomad/docs/enterprise#resource-quotas)
+enable an operator to limit resource consumption across teams
+or projects to reduce waste and align budgets.
+
+Quotas can be managed using the Nomad CLI via the
+[`quota`](/nomad/docs/commands/quota)
+subcommands, or with Nomad's
+[HTTP API](/nomad/api-docs/quotas)
+directly.
+
+You may also follow a
+[Quotas tutorial](/nomad/tutorials/governance-and-policy/quotas)
+for more example usage.
+
+## Example Quota Specification
+
+The CLI command `nomad quota init` generates an example `spec.hcl` file:
+
+```hcl
+name        = "default-quota"
+description = "Limit the shared default namespace"
+
+# Create a limit for the global region. Additional limits may
+# be specified in-order to limit other regions.
+limit {
+  region = "global"
+  region_limit {
+    cores      = 0
+    cpu        = 2500
+    memory     = 1000
+    memory_max = 1000
+    device "nvidia/gpu/1080ti" {
+      count = 1
+    }
+  }
+  variables_limit = 1000
+}
+```
+
+## Quota Specification Parameters
+
+- `name` `(string)` - The name of the Quota. This will be used to connect it to a
+[`Namespace`](/nomad/docs/other-specifications/namespace).
+- `description` `(string: <optional>)` - A human-readable description.
+- `limit` <code>([QuotaLimit](#limit-parameters))</code> - The resource limit in a Nomad region.
+
+### `limit` Parameters
+
+- `region` `(string)` - The Nomad `region` that the limit applies to.
+- `region_limit` <code>([RegionLimit](#region_limit-parameters))</code> - Resources to limit.
+- `variables_limit` `(int: 0)` - Maximum total size of all Nomad
+[`variables`](/nomad/docs/concepts/variables)
+in MiB. The default `0` means unlimited, and `-1` means variables are fully disabled.
+
+### `region_limit` Parameters
+
+These are associated with the parameters on a task
+[`resources`](/nomad/docs/job-specification/resources)
+block in a job specification, and the
+[CPU concepts](/nomad/docs/concepts/cpu)
+page has more information regarding CPU resources as well.
+
+- `cores` `(int: <optional>)` - Number of CPU cores
+- `cpu` `(int: <optional>)` - Amount of CPU in MHz
+- `memory` `(int: <optional>)` - Amount of memory in MB
+- `memory_max` `(int: <optional>)` - Max amount of memory in MB
+- `device` <code>([Device](#device-parameters): nil)</code>
+
+### `device` Parameters
+
+The `device` label specifies which device(s) the quota applies to,
+equivalent to the
+[`device`](/nomad/docs/job-specification/device#device-parameters)
+in a job specification.
+
+- `count` `(int)` - How many of this device may be used.

website/data/docs-nav-data.json

@@ -1915,6 +1915,10 @@
         "title": "Node Pool",
         "path": "other-specifications/node-pool"
       },
+      {
+        "title": "Quota",
+        "path": "other-specifications/quota"
+      },
       {
         "title": "Variables",
         "path": "other-specifications/variables"