Skip to content

Commit

Permalink
docs: remove description from frontmatter
Browse files Browse the repository at this point in the history
According to
https://developer.hashicorp.com/terraform/registry/providers/docs#yaml-frontmatter,
the frontmatter does not support a description field.

Regardless, we place the description as the first section each
document.
  • Loading branch information
drbild committed Nov 25, 2024
1 parent da5102b commit 9228a2a
Show file tree
Hide file tree
Showing 18 changed files with 0 additions and 56 deletions.
5 changes: 0 additions & 5 deletions docs/data-sources/blueprint.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,6 @@
---
page_title: "resourcely_blueprint Data Source - terraform-provider-resourcely"
subcategory: ""
description: |-
A blueprint is a configuration template used to provision cloud infrastructure resources. Blueprints allow you to:
Define which options are available for properties of your resource(s).Apply gaurdrails to your resource(s) to prevent misconfiguration.Define what information to collect from your developers before provisioning the resource.
Once a blueprint is configured and published, it becomes available for use in your Resourcely service catalog.
The template is specified using Resourcely's TFT templating language. See the Authoring Your Own Blueprints https://docs.resourcely.io/build/setting-up-blueprints/authoring-your-own-blueprints docs for details about TFT. The Resourcely Foundry https://portal.resourcely.io/foundry?mode=blueprint provides an IDE to assist with authoring the template.
---

# resourcely_blueprint (Data Source)
Expand Down
6 changes: 0 additions & 6 deletions docs/data-sources/context_question.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,6 @@
---
page_title: "resourcely_context_question Data Source - terraform-provider-resourcely"
subcategory: ""
description: |-
A context question https://docs.resourcely.io/concepts/other-features-and-settings/global-context-and-values is used to gather data from developers before provisioning a resource. They are designed to gather and store insightful data related to the resource.
Some examples include:
What type of data will be stored in this infrastructure?What application is this infrastructure associated with?What is the email address the person/team responsible for this infrastructure?
Three types of context questions are supported:
TextSingle ChoiceMultiple Choice
---

# resourcely_context_question (Data Source)
Expand Down
2 changes: 0 additions & 2 deletions docs/data-sources/global_value.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
---
page_title: "resourcely_global_value Data Source - terraform-provider-resourcely"
subcategory: ""
description: |-
A global value https://docs.resourcely.io/concepts/other-features-and-settings/global-values allows admins to define custom drop-downs for customizing Terraform infrastructure resource properties before they are provisioned. They are useful for providing access to lists of relatively static values like VPC IDs, allowed regions, department or team names, etc.
---

# resourcely_global_value (Data Source)
Expand Down
4 changes: 0 additions & 4 deletions docs/data-sources/guardrail.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,6 @@
---
page_title: "resourcely_guardrail Data Source - terraform-provider-resourcely"
subcategory: ""
description: |-
A guardrail governs how cloud resources can be created and altered, preventing infrastructure misconfiguration. Before infrastructure is provisioned, Resourcely examines the changes being made and prevents a merge if any guardrail requirements are violated. Some examples of guardrails include:
Require approval for making a public S3 bucketRestrict the allowed compute instance types or images
Guardrails are specified using the Really policy language https://docs.resourcely.io/build/setting-up-guardrails/authoring-your-own-guardrails.
---

# resourcely_guardrail (Data Source)
Expand Down
2 changes: 0 additions & 2 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
---
page_title: "Provider: resourcely"
description: |-
Manage Resourcely blueprints, guardrails, global values, and more through Terraform.
---

# RESOURCELY Provider
Expand Down
5 changes: 0 additions & 5 deletions docs/resources/blueprint.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,6 @@
---
page_title: "resourcely_blueprint Resource - terraform-provider-resourcely"
subcategory: ""
description: |-
A blueprint is a configuration template used to provision cloud infrastructure resources. Blueprints allow you to:
Define which options are available for properties of your resource(s).Apply gaurdrails to your resource(s) to prevent misconfiguration.Define what information to collect from your developers before provisioning the resource.
Once a blueprint is configured and published, it becomes available for use in your Resourcely service catalog.
The template is specified using Resourcely's TFT templating language. See the Authoring Your Own Blueprints https://docs.resourcely.io/build/setting-up-blueprints/authoring-your-own-blueprints docs for details about TFT. The Resourcely Foundry https://portal.resourcely.io/foundry?mode=blueprint provides an IDE to assist with authoring the template.
---

# resourcely_blueprint (Resource)
Expand Down
6 changes: 0 additions & 6 deletions docs/resources/context_question.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,6 @@
---
page_title: "resourcely_context_question Resource - terraform-provider-resourcely"
subcategory: ""
description: |-
A context question https://docs.resourcely.io/concepts/other-features-and-settings/global-context-and-values is used to gather data from developers before provisioning a resource. They are designed to gather and store insightful data related to the resource.
Some examples include:
What type of data will be stored in this infrastructure?What application is this infrastructure associated with?What is the email address the person/team responsible for this infrastructure?
Three types of context questions are supported:
TextSingle ChoiceMultiple Choice
---

# resourcely_context_question (Resource)
Expand Down
3 changes: 0 additions & 3 deletions docs/resources/global_value.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,6 @@
---
page_title: "resourcely_global_value Resource - terraform-provider-resourcely"
subcategory: ""
description: |-
A global value https://docs.resourcely.io/concepts/other-features-and-settings/global-values allows admins to define custom drop-downs for customizing Terraform infrastructure resource properties before they are provisioned. They are useful for providing access to lists of relatively static values like VPC IDs, allowed regions, department or team names, etc.
This global value API does not support deletion. Deleting the Terraform resource will remove the resource from the Terraform state file, but will not actually delete the global value entity. Set is_deprecated = true to tell Resourcely that this global value should no longer be used by new blueprints or guardrails.
---

# resourcely_global_value (Resource)
Expand Down
5 changes: 0 additions & 5 deletions docs/resources/guardrail.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,6 @@
---
page_title: "resourcely_guardrail Resource - terraform-provider-resourcely"
subcategory: ""
description: |-
A guardrail governs how cloud resources can be created and altered, preventing infrastructure misconfiguration. Before infrastructure is provisioned, Resourcely examines the changes being made and prevents a merge if any guardrail requirements are violated.
Some examples of guardrails include:
Require approval for making a public S3 bucketRestrict the allowed compute instance types or images
Guardrails are specified using the Really policy language https://docs.resourcely.io/build/setting-up-guardrails/authoring-your-own-guardrails.
---

# resourcely_guardrail (Resource)
Expand Down
2 changes: 0 additions & 2 deletions templates/data-sources/blueprint.md.tmpl
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
---
page_title: "{{.Name}} {{.Type}} - {{.ProviderName}}"
subcategory: ""
description: |-
{{ .Description | plainmarkdown | trimspace | prefixlines " " }}
---

# {{.Name}} ({{.Type}})
Expand Down
2 changes: 0 additions & 2 deletions templates/data-sources/context_question.md.tmpl
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
---
page_title: "{{.Name}} {{.Type}} - {{.ProviderName}}"
subcategory: ""
description: |-
{{ .Description | plainmarkdown | trimspace | prefixlines " " }}
---

# {{.Name}} ({{.Type}})
Expand Down
2 changes: 0 additions & 2 deletions templates/data-sources/global_value.md.tmpl
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
---
page_title: "{{.Name}} {{.Type}} - {{.ProviderName}}"
subcategory: ""
description: |-
{{ .Description | plainmarkdown | trimspace | prefixlines " " }}
---

# {{.Name}} ({{.Type}})
Expand Down
2 changes: 0 additions & 2 deletions templates/data-sources/guardrail.md.tmpl
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
---
page_title: "{{.Name}} {{.Type}} - {{.ProviderName}}"
subcategory: ""
description: |-
{{ .Description | plainmarkdown | trimspace | prefixlines " " }}
---

# {{.Name}} ({{.Type}})
Expand Down
2 changes: 0 additions & 2 deletions templates/index.md.tmpl
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
---
page_title: "Provider: resourcely"
description: |-
Manage Resourcely blueprints, guardrails, global values, and more through Terraform.
---

# {{ .ProviderShortName | upper }} Provider
Expand Down
2 changes: 0 additions & 2 deletions templates/resources/blueprint.md.tmpl
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
---
page_title: "{{.Name}} {{.Type}} - {{.ProviderName}}"
subcategory: ""
description: |-
{{ .Description | plainmarkdown | trimspace | prefixlines " " }}
---

# {{.Name}} ({{.Type}})
Expand Down
2 changes: 0 additions & 2 deletions templates/resources/context_question.md.tmpl
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
---
page_title: "{{.Name}} {{.Type}} - {{.ProviderName}}"
subcategory: ""
description: |-
{{ .Description | plainmarkdown | trimspace | prefixlines " " }}
---

# {{.Name}} ({{.Type}})
Expand Down
2 changes: 0 additions & 2 deletions templates/resources/global_value.md.tmpl
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
---
page_title: "{{.Name}} {{.Type}} - {{.ProviderName}}"
subcategory: ""
description: |-
{{ .Description | plainmarkdown | trimspace | prefixlines " " }}
---

# {{.Name}} ({{.Type}})
Expand Down
2 changes: 0 additions & 2 deletions templates/resources/guardrail.md.tmpl
Original file line number Diff line number Diff line change
@@ -1,8 +1,6 @@
---
page_title: "{{.Name}} {{.Type}} - {{.ProviderName}}"
subcategory: ""
description: |-
{{ .Description | plainmarkdown | trimspace | prefixlines " " }}
---

# {{.Name}} ({{.Type}})
Expand Down

0 comments on commit 9228a2a

Please sign in to comment.