Merge pull request #15 from platform9/feat/docs-guides

docs: per-resource examples, service subcategories, and auth/migration guides

Author: PF9-pushkar

.gitignore

@@ -33,9 +33,11 @@ PCD-CE-Deployment-Handoff.md
 
 # Generated registry docs — produced by `make generate` (tfplugindocs) on demand and
 # at release time; not committed. (docs/compatibility/ is hand-written and kept.)
+# Guides are authored in templates/guides/ and rendered into docs/guides/.
 /docs/index.md
 /docs/resources/
 /docs/data-sources/
+/docs/guides/
 
 # Editors / OS
 .idea/

CHANGELOG.md

@@ -0,0 +1,3 @@
+data "pcd_blockstorage_snapshot" "example" {
+  name = "tf-example-snapshot"
+}

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

@@ -0,0 +1,3 @@
+data "pcd_blockstorage_volume" "example" {
+  name = "tf-example-volume"
+}

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

@@ -0,0 +1,3 @@
+data "pcd_compute_availability_zones" "example" {
+  state = "available"
+}

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

@@ -0,0 +1,3 @@
+data "pcd_compute_flavor" "example" {
+  name = "m1.large"
+}

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

@@ -0,0 +1,3 @@
+data "pcd_compute_keypair" "example" {
+  name = "tf-example-keypair"
+}

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

@@ -0,0 +1,4 @@
+data "pcd_identity_auth_scope" "example" {
+  name   = "tf-example-scope"
+  region = "RegionOne"
+}

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

@@ -0,0 +1,3 @@
+data "pcd_identity_project" "example" {
+  name = "tf-example-project"
+}

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

@@ -0,0 +1,3 @@
+data "pcd_identity_role" "example" {
+  name = "member"
+}