diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1c906629..c4eb05b2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,6 +3,7 @@
 ENHANCEMENTS
 
 * resource/netbox_ip_address: Add `role` attribute
+* resource/netbox_available_ip_address: improve documentation by [@holmesb](https://github.com/holmesb)
 
 ## 2.0.3 (July 8th, 2022)
 
diff --git a/examples/resources/netbox_available_ip_address/assign_to_interface.tf b/examples/resources/netbox_available_ip_address/assign_to_interface.tf
new file mode 100644
index 00000000..019dbf73
--- /dev/null
+++ b/examples/resources/netbox_available_ip_address/assign_to_interface.tf
@@ -0,0 +1,19 @@
+// Assumes Netbox already has a VM whos name matches 'dc-west-myvm-20'
+data "netbox_virtual_machine" "myvm" {
+  name_regex = "dc-west-myvm-20"
+}
+
+data "netbox_prefix" "test" {
+  cidr = "10.0.0.0/24"
+}
+
+resource "netbox_interface" "myvm-eth0" {
+  name = "eth0"
+  virtual_machine_id = data.netbox_virtual_machine.myvm.id
+}
+
+resource "netbox_available_ip_address" "myvm-ip" {
+  prefix_id = data.netbox_prefix.test.id
+  status = "active"
+  interface_id = netbox_interface.myvm-eth0.id
+}
diff --git a/examples/resources/netbox_available_ip_address/prefix.tf b/examples/resources/netbox_available_ip_address/prefix.tf
new file mode 100644
index 00000000..c2582dcf
--- /dev/null
+++ b/examples/resources/netbox_available_ip_address/prefix.tf
@@ -0,0 +1,7 @@
+data "netbox_prefix" "test" {
+  cidr = "10.0.0.0/24"
+}
+
+resource "netbox_available_ip_address" "test" {
+  prefix_id = data.netbox_prefix.test.id
+}
diff --git a/examples/resources/netbox_available_ip_address/range.tf b/examples/resources/netbox_available_ip_address/range.tf
new file mode 100644
index 00000000..d845d2e5
--- /dev/null
+++ b/examples/resources/netbox_available_ip_address/range.tf
@@ -0,0 +1,8 @@
+data "netbox_ip_range" "test" {
+  start_address = "10.0.0.1/24"
+  end_address = "10.0.0.50/24"
+}
+
+resource "netbox_available_ip_address" "test" {
+  ip_range_id = data.netbox_ip_range.test.id
+}
diff --git a/examples/resources/netbox_available_ip_address/resource.tf b/examples/resources/netbox_available_ip_address/resource.tf
deleted file mode 100644
index ac46db3e..00000000
--- a/examples/resources/netbox_available_ip_address/resource.tf
+++ /dev/null
@@ -1,36 +0,0 @@
-data "netbox_prefix" "test" {
-  cidr = "10.0.0.0/24"
-}
-
-resource "netbox_available_ip_address" "test" {
-  prefix_id = data.netbox_prefix.test.id
-}
-
-data "netbox_ip_range" "test" {
-  start_address = "10.0.0.1/24"
-  end_address   = "10.0.0.50/24"
-}
-
-resource "netbox_available_ip_address" "test" {
-  ip_range_id = data.netbox_ip_range.test.id
-}
-
-// Assumes Netbox already has a VM whos name matches 'dc-west-myvm-20'
-data "netbox_virtual_machine" "myvm" {
-  name_regex = "dc-west-myvm-20"
-}
-
-data "netbox_prefix" "test" {
-  cidr = "10.0.0.0/24"
-}
-
-resource "netbox_interface" "myvm_eth0" {
-  name               = "eth0"
-  virtual_machine_id = data.netbox_virtual_machine.myvm.id
-}
-
-resource "netbox_available_ip_address" "myvm_ip" {
-  prefix_id    = data.netbox_prefix.test.id
-  status       = "active"
-  interface_id = netbox_interface.myvm_eth0.id
-}
diff --git a/netbox/resource_netbox_available_ip_address.go b/netbox/resource_netbox_available_ip_address.go
index ed76e685..d1635036 100644
--- a/netbox/resource_netbox_available_ip_address.go
+++ b/netbox/resource_netbox_available_ip_address.go
@@ -16,6 +16,20 @@ func resourceNetboxAvailableIPAddress() *schema.Resource {
 		Update: resourceNetboxAvailableIPAddressUpdate,
 		Delete: resourceNetboxAvailableIPAddressDelete,
 
+		Description: `Per [the docs](https://netbox.readthedocs.io/en/stable/models/ipam/ipaddress/):
+
+> An IP address comprises a single host address (either IPv4 or IPv6) and its subnet mask. Its mask should match exactly how the IP address is configured on an interface in the real world.
+> Like a prefix, an IP address can optionally be assigned to a VRF (otherwise, it will appear in the "global" table). IP addresses are automatically arranged under parent prefixes within their respective VRFs according to the IP hierarchya.
+>
+> Each IP address can also be assigned an operational status and a functional role. Statuses are hard-coded in NetBox and include the following: 
+> * Active
+> * Reserved
+> * Deprecated
+> * DHCP
+> * SLAAC (IPv6 Stateless Address Autoconfiguration)
+
+This resource will retrieve the next available IP address from a given prefix or IP range (specified by ID)`,
+
 		Schema: map[string]*schema.Schema{
 			"prefix_id": &schema.Schema{
 				Type:         schema.TypeInt,
diff --git a/templates/resources/available_ip_address.md.tmpl b/templates/resources/available_ip_address.md.tmpl
new file mode 100644
index 00000000..af5ad3f4
--- /dev/null
+++ b/templates/resources/available_ip_address.md.tmpl
@@ -0,0 +1,41 @@
+---
+page_title: "{{.Name}} {{.Type}} - {{.ProviderName}}"
+subcategory: ""
+description: |-
+{{ .Description | plainmarkdown | trimspace | prefixlines "  " }}
+---
+
+# {{.Name}} ({{.Type}})
+
+{{ .Description | trimspace }}
+
+## Example Usage
+### Creating an IP in a prefix
+{{ tffile "examples/resources/netbox_available_ip_address/prefix.tf" }}
+
+### Creating an IP in an IP range
+{{ tffile "examples/resources/netbox_available_ip_address/range.tf" }}
+
+### Marking an IP active and assigning to interface
+{{ tffile "examples/resources/netbox_available_ip_address/assign_to_interface.tf" }}
+
+## Schema
+
+### Required
+
+- Either **prefix_id** or **ip_range_id** (String)
+
+### Optional
+
+- **description** (String)
+- **dns_name** (String)
+- **interface_id** (Number)
+- **status** (String) Defaults to "active".  Choose from "active", "reserved", "deprecated", "dhcp", or "slaac"
+- **tags** (Set of String)
+- **tenant_id** (Number)
+- **vrf_id** (Number)
+
+### Read-Only
+
+- **id** (String) The ID of this resource.
+- **ip_address** (String)