From 59018323ae857d5fe258d906ec81b1f68e26021e Mon Sep 17 00:00:00 2001
From: Graham Christensen <graham@grahamc.com>
Date: Mon, 28 Jun 2021 09:59:38 -0400
Subject: [PATCH] Docs: document derivation attributes

---
 doc/manual/src/SUMMARY.md |  1 +
 doc/manual/src/jobs.md    | 21 +++++++++++++++++++++
 2 files changed, 22 insertions(+)
 create mode 100644 doc/manual/src/jobs.md

diff --git a/doc/manual/src/SUMMARY.md b/doc/manual/src/SUMMARY.md
index a13cc98d..b3a58a96 100644
--- a/doc/manual/src/SUMMARY.md
+++ b/doc/manual/src/SUMMARY.md
@@ -3,6 +3,7 @@
 - [Introduction](introduction.md)
 - [Installation](installation.md)
 - [Creating and Managing Projects](projects.md)
+- [Hydra jobs](./jobs.md)
 - [Using the external API](api.md)
 - [Monitoring Hydra](./monitoring/README.md)
 
diff --git a/doc/manual/src/jobs.md b/doc/manual/src/jobs.md
new file mode 100644
index 00000000..2863838e
--- /dev/null
+++ b/doc/manual/src/jobs.md
@@ -0,0 +1,21 @@
+# Hydra Jobs
+
+## Derivation Attributes
+
+Hydra stores the following job attributes in its database:
+
+* `nixName` - the Derivation's `name` attribute
+* `system` - the Derivation's `system` attribute
+* `drvPath` - the Derivation's path in the Nix store
+* `outputs` - A JSON dictionary of output names and their store path.
+
+### Meta fields
+
+* `description` - `meta.description`, a string
+* `license` - a comma separated list of license names from `meta.license`, expected to be a list of attribute sets with an attribute named `shortName`, ex: `[ { shortName = "licensename"} ]`.
+* `homepage` - `meta.homepage`, a string
+* `maintainers` - a comma separated list of maintainer email addresses from `meta.maintainers`, expected to be a list of attribute sets with an attribute named `email`, ex: `[ { email = "alice@example.com"} ]`.
+* `schedulingPriority` - `meta.schedulingPriority`, an integer. Default: 100. Slightly prioritizes this job over other jobs within this jobset.
+* `timeout` - `meta.timeout`, an integer. Default: 36000. Number of seconds this job must complete within.
+* `maxSilent` - `meta.maxSilent`, an integer. Default: 7200. Number of seconds of no output on stderr / stdout before considering the job failed. 
+* `isChannel` - `meta.isHydraChannel`, bool. Default: false. Deprecated.