docs: interaction between instances and reserved ip (#371)

Author: muse-sisay

Diff for: docs/resources/instance_reserved_ip_assignment.md

@@ -8,7 +8,7 @@ description: |-
 
 # civo_instance_reserved_ip_assignment (Resource)
 
-The instance reserved ip assignment resource schema definition
+The instance reserved ip assignment resource schema definition. If you are using this resource to assign a reserved IP to an instance, instances `public_ip` attribute won't be updated until the next state refresh. If subsequent resources are relying instances public IP consider assigning the reserved ip address to the instance.
 
 ## Example Usage
 

Diff for: docs/resources/reserved_ip.md

@@ -12,10 +12,32 @@ Provides a Civo reserved IP to represent a publicly-accessible static IP address
 
 ## Example Usage
 
+A `civo_reserved_ip` can be assigned to an `civo-instance` either by setting `reserved_ipv4` field for `civo-instance` or using `civo_instance_reserved_ip_assignment` resource.
+
 ```terraform
 resource "civo_reserved_ip" "www" {
     name = "nginx-www" 
 }
+
+resource "civo_instance" "webserver" {
+    # ...  removed for brevity
+    reserved_ipv4 = civo_reserved_ip.www.ip
+}
+```
+
+```terraform
+resource "civo_reserved_ip" "www" {
+    name = "nginx-www" 
+}
+
+resource "civo_instance" "webserver" {
+    # ...  removed for brevity
+}
+
+resource "civo_instance_reserved_ip_assignment" "webserver-www" {
+    instance_id    = civo_instance.webserver.id
+    reserved_ip_id = civo_reserved_ip.www.id
+}
 ```
 
 <!-- schema generated by tfplugindocs -->