diff --git a/docs/control/fans.md b/docs/control/fans.md
new file mode 100644
index 0000000..c5c32d5
--- /dev/null
+++ b/docs/control/fans.md
@@ -0,0 +1,31 @@
+# fans.json
+
+## JSON Example
+
+```
+[
+    {
+        "name": "fan0",
+        "zone": "0",
+        "sensors": ["fan0_0"],
+        "target_interface": "xyz.openbmc_project.Control.FanSpeed"
+    }
+    ...
+]
+```
+
+## Attributes
+
+### name
+The D-Bus name of the fan FRU. Required.
+
+### zone
+The zone the fan is in. Required.
+
+### sensors
+The D-bus sensor names associated with that fan. Required.
+
+### target_interface
+The D-Bus interface to use for setting the fan target speed/PWM. Either
+`xyz.openbmc_project.Control.FanSpeed` for RPM controlled fans or
+`xyz.openbmc_project.Control.FanPWM` for PWM controlled fans. Required.