docs: add doc usage

docs/resources/access_offer.md

@@ -10,7 +10,14 @@ description: |-
 
 A resource that represent a Juju Access Offer. Warning: Do not repeat users across different access levels.
 
+## Example Usage
 
+```terraform
+resource "juju_access_offer" "this" {
+  offer_url = juju_offer.my_application_offer.url
+  consume   = [juju_user.dev.name]
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
@@ -28,3 +35,16 @@ A resource that represent a Juju Access Offer. Warning: Do not repeat users acro
 ### Read-Only
 
 - `id` (String) The ID of this resource.
+
+## Import
+
+Import is supported using the following syntax:
+
+```shell
+# Access Offers can be imported by using the Offer URL as in the juju show-offers output.
+# Example:
+# $juju show-offer mysql
+# Store            URL             Access  Description                                    Endpoint  Interface  Role
+# mycontroller     admin/db.mysql  admin   MariaDB Server is one of the most ...          mysql     mysql      provider
+$ terraform import juju_access_offer.db admin/db.mysql
+```

examples/resources/juju_access_offer/import.sh

@@ -0,0 +1,6 @@
+# Access Offers can be imported by using the Offer URL as in the juju show-offers output.
+# Example:
+# $juju show-offer mysql
+# Store            URL             Access  Description                                    Endpoint  Interface  Role
+# mycontroller     admin/db.mysql  admin   MariaDB Server is one of the most ...          mysql     mysql      provider
+$ terraform import juju_access_offer.db admin/db.mysql

examples/resources/juju_access_offer/resource.tf

@@ -0,0 +1,4 @@
+resource "juju_access_offer" "this" {
+  offer_url = juju_offer.my_application_offer.url
+  consume   = [juju_user.dev.name]
+}