diff --git a/README.md b/README.md
index ec641e0c..76593195 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,72 @@
-# devicetype-library
-A collection of community-sourced DeviceType definitions for import to NetBox
+# About this Library
+
+This library is intended to be used for populating device types in [NetBox](https://github.com/netbox-community/netbox). It contains a set of device type definitions expressed in YAML and arranged by manufacturer. Each file represents a discrete physical device type (e.g. make and model). These definitions can be loaded into NetBox to obviate the need to create device types and their associated components manually.
+
+# Device Type Definitions
+
+Each definition must include at minimum the following fields:
+
+* `manufacturer`: The name of the manufacturer which produces this device type.
+* `model`: The model number of the device type. This must be unique per manufacturer.
+* `slug`: A URL-friendly representation of the model number. Like the model number, this must be unique per manufacturer.
+
+The following fields may optionally be declared:
+
+* `part_number`: An alternative representation of the model number (e.g. a SKU).
+* `u_height`: The height of the device type in rack units. (Default: 1)
+* `is_full_depth`: A boolean which indicates whether the device type consumes both the front and rear rack faces. (Default: true)
+* `comments`: Free-form comments concerning the device type. These must be universally applicable to the specific device type.
+
+## Component Definitions
+
+Valid component types are listed below. Each type of component must declare a list of the individual component templates to be added.
+
+* `console_ports`
+* `console_server_ports`
+* `power_ports`
+* `power_outlets`
+* `interfaces`
+* `rear_ports`
+* `front_ports`
+
+The available fields for each type of component are listed below.
+
+### Console Ports
+
+* `name`: Port name
+
+### Console Server Ports
+
+* `name`: Port name
+
+### Power Ports
+
+* `name`: Port name
+* `maximum_draw`: The port's maximum power draw, in watts (optional)
+* `allocated_draw`: The port's allocated power draw, in watts (optional)
+
+### Power Outlers
+
+* `name`: Outlet name
+* `power_port`: The name of the power port on the device which powers this outlet (optional)
+* `feed_leg`: The phase (leg) of power to which this outlet is mapped (optional)
+
+### Interfaces
+
+* `name`: Interface name
+* `type`: Inteface type
+* `mgmt_only`: A boolean which indicates whether this interface is used for management purposes only (default: false)
+
+### Rear Ports
+
+* `name`: Port name
+* `type`: Port type
+* `positions`: The number of front ports that can map to this rear port (default: 1)
+
+### Front Ports
+
+* `name`: Port name
+* `type`: Port type
+* `rear_port`: The name of the rear port on this device to which the front port maps
+* `rear_port_position`: The corresponding position on the mapped rear port (default: 1)
+