Add example usage for data sources and update docs

- Add example usage sections to API keys, container images, and regions
  data source docs
- Add corresponding Terraform example files for each data source
- Update .gitignore to include Terraform state and lock files
- Update .terraformrc.example with placeholder provider path
- Remove obsolete .terraform.lock.hcl from local-spice-api example

Author: ewgenius

.gitignore

@@ -16,6 +16,8 @@ website/node_modules
 *.backup
 ./*.tfstate
 .terraform/
+.terraform.lock.hcl
+terraform.tfstate
 *.log
 *.bak
 *~

docs/data-sources/api_keys.md

@@ -10,7 +10,28 @@ description: |-
 
 Retrieves the API keys for a Spice.ai app. Each app has two API keys to support key rotation.
 
-
+## Example Usage
+
+```terraform
+# Get API keys for an app
+data "spiceai_api_keys" "example" {
+  app_id = spiceai_app.example.id
+}
+
+# Use the primary API key
+output "primary_api_key" {
+  description = "The primary API key for the app"
+  value       = data.spiceai_api_keys.example.api_key
+  sensitive   = true
+}
+
+# Use the secondary API key (useful for key rotation)
+output "secondary_api_key" {
+  description = "The secondary API key for the app"
+  value       = data.spiceai_api_keys.example.api_key_2
+  sensitive   = true
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/data-sources/container_images.md

@@ -10,7 +10,31 @@ description: |-
 
 Retrieves a list of available Spice.ai runtime container images.
 
-
+## Example Usage
+
+```terraform
+# Get available stable container images
+data "spiceai_container_images" "stable" {
+  channel = "stable"
+}
+
+# Get available enterprise container images
+data "spiceai_container_images" "enterprise" {
+  channel = "enterprise"
+}
+
+# Output the default image tag
+output "default_image_tag" {
+  description = "The default container image tag"
+  value       = data.spiceai_container_images.stable.default
+}
+
+# Output all available image tags
+output "available_image_tags" {
+  description = "List of available container image tags"
+  value       = [for image in data.spiceai_container_images.stable.images : image.tag]
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/data-sources/regions.md

@@ -10,7 +10,40 @@ description: |-
 
 Retrieves a list of available deployment regions for Spice.ai apps.
 
+## Example Usage
 
+```terraform
+# Get all available deployment regions
+data "spiceai_regions" "all" {}
+
+# Get only production regions
+data "spiceai_regions" "prod" {
+  env = "prod"
+}
+
+# Output the default region
+output "default_region" {
+  description = "The default deployment region"
+  value       = data.spiceai_regions.all.default
+}
+
+# Output all available region identifiers
+output "available_regions" {
+  description = "List of available deployment regions"
+  value       = [for region in data.spiceai_regions.all.regions : region.region]
+}
+
+# Output region details
+output "regions_info" {
+  description = "Detailed information about available regions"
+  value = [for region in data.spiceai_regions.all.regions : {
+    name     = region.name
+    region   = region.region
+    cname    = region.cname
+    provider = region.provider_name
+  }]
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

examples/.terraformrc.example

@@ -11,7 +11,7 @@
 provider_installation {
   dev_overrides {
     # Update this path to where your terraform-provider-spiceai binary is located
-    "spiceai/spiceai" = "/Users/evgenii/Developer/Spice/terraform-provider-spiceai"
+    "spiceai/spiceai" = "/path/to/terraform-provider-spiceai"
   }
 
   # Fall back to the default installation behavior for all other providers

examples/data-sources/spiceai_api_keys/data-source.tf

@@ -0,0 +1,18 @@
+# Get API keys for an app
+data "spiceai_api_keys" "example" {
+  app_id = spiceai_app.example.id
+}
+
+# Use the primary API key
+output "primary_api_key" {
+  description = "The primary API key for the app"
+  value       = data.spiceai_api_keys.example.api_key
+  sensitive   = true
+}
+
+# Use the secondary API key (useful for key rotation)
+output "secondary_api_key" {
+  description = "The secondary API key for the app"
+  value       = data.spiceai_api_keys.example.api_key_2
+  sensitive   = true
+}

examples/data-sources/spiceai_container_images/data-source.tf

@@ -0,0 +1,21 @@
+# Get available stable container images
+data "spiceai_container_images" "stable" {
+  channel = "stable"
+}
+
+# Get available enterprise container images
+data "spiceai_container_images" "enterprise" {
+  channel = "enterprise"
+}
+
+# Output the default image tag
+output "default_image_tag" {
+  description = "The default container image tag"
+  value       = data.spiceai_container_images.stable.default
+}
+
+# Output all available image tags
+output "available_image_tags" {
+  description = "List of available container image tags"
+  value       = [for image in data.spiceai_container_images.stable.images : image.tag]
+}

examples/data-sources/spiceai_regions/data-source.tf

@@ -0,0 +1,30 @@
+# Get all available deployment regions
+data "spiceai_regions" "all" {}
+
+# Get only production regions
+data "spiceai_regions" "prod" {
+  env = "prod"
+}
+
+# Output the default region
+output "default_region" {
+  description = "The default deployment region"
+  value       = data.spiceai_regions.all.default
+}
+
+# Output all available region identifiers
+output "available_regions" {
+  description = "List of available deployment regions"
+  value       = [for region in data.spiceai_regions.all.regions : region.region]
+}
+
+# Output region details
+output "regions_info" {
+  description = "Detailed information about available regions"
+  value = [for region in data.spiceai_regions.all.regions : {
+    name     = region.name
+    region   = region.region
+    cname    = region.cname
+    provider = region.provider_name
+  }]
+}