docs examples

Author: Gary James

docs/index.md

@@ -6,11 +6,20 @@ description: |-
   
 ---
 
-# dbt-cloud Provider
-
+# DBT Cloud Provider
 
+This is a terraform provider plugin for managing [DBT Cloud](https://cloud.getdbt.com/) accounts.
+Given the current capabilities of the API we focus on the management of job definitions.
 
+## Example Provider Configuration
 
+```terraform
+provider "dbt" {
+  // required
+  account_id = ...
+  token      = "..."
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/resources/dbt_cloud_job.md

@@ -8,9 +8,19 @@ description: |-
 
 # dbt_cloud_job (Resource)
 
-
-
-
+## Example Usage
+
+```terraform
+resource "dbt_cloud_job" "test" {
+  project_id     = 101
+  environment_id = 1
+  name           = "Test job"
+  execute_steps  = [
+    "dbt run",
+    "dbt test"
+  ]
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema