Merge pull request #2060 from Cyb3r-Jak3/git-account-pages

Adds note about linking git acocunts and Cloudflare

.changelog/2060.txt

@@ -0,0 +1,7 @@
+```release-note:enhancement
+resource/cloudflare_pages_project: add note about linking git accounts to Cloudflare account.
+```
+
+```release-note:enhancement
+resource/cloudflare_pages_domain: add note about needing to make a separate `cloudflare_record`.
+```

docs/resources/pages_domain.md

@@ -9,6 +9,8 @@ description: |-
 
 Provides a resource for managing Cloudflare Pages domains.
 
+-> A DNS record for the domain is not automatically created. You need to create a `cloudflare_record` resource for the domain you want to use.
+
 ## Example Usage
 
 ```terraform
@@ -18,6 +20,7 @@ resource "cloudflare_pages_domain" "my-domain" {
   domain       = "example.com"
 }
 ```
+
 <!-- schema generated by tfplugindocs -->
 ## Schema
 
@@ -38,4 +41,4 @@ Import is supported using the following syntax:
 
 ```shell
 $ terraform import cloudflare_pages_domain.example <account_id>/<project_name>/<domain-name>
-```
+```

docs/resources/pages_project.md

@@ -9,6 +9,10 @@ description: |-
 
 Provides a resource which manages Cloudflare Pages projects.
 
+-> If you are using a `source` block configuration, you must first have a
+connected GitHub or GitLab account connected to Cloudflare. See the
+[Getting Started with Pages] documentation on how to link your accounts.
+
 ## Example Usage
 
 ```terraform
@@ -106,6 +110,7 @@ resource "cloudflare_pages_project" "deployment_configs" {
   }
 }
 ```
+
 <!-- schema generated by tfplugindocs -->
 ## Schema
 
@@ -210,3 +215,5 @@ Import is supported using the following syntax:
 ```shell
 $ terraform import cloudflare_pages_project.example <account_id>/<project_name>
 ```
+
+[Getting Started with Pages]: https://developers.cloudflare.com/pages/get-started/#connect-your-git-provider-to-pages

templates/resources/pages_domain.md.tmpl

@@ -0,0 +1,24 @@
+---
+page_title: "{{.Name}} {{.Type}} - {{.RenderedProviderName}}"
+subcategory: ""
+description: |-
+{{ .Description | plainmarkdown | trimspace | prefixlines "  " }}
+---
+
+# {{.Name}} ({{.Type}})
+
+{{ .Description | trimspace }}
+
+-> A DNS record for the domain is not automatically created. You need to create a `cloudflare_record` resource for the domain you want to use.
+
+## Example Usage
+
+{{ tffile (printf "%s%s%s" "examples/resources/" .Name "/resource.tf") }}
+
+{{ .SchemaMarkdown | trimspace }}
+
+## Import
+
+Import is supported using the following syntax:
+
+{{ codefile "shell" (printf "%s%s%s" "examples/resources/" .Name "/import.sh") }}

templates/resources/pages_project.md.tmpl

@@ -0,0 +1,28 @@
+---
+page_title: "{{.Name}} {{.Type}} - {{.RenderedProviderName}}"
+subcategory: ""
+description: |-
+{{ .Description | plainmarkdown | trimspace | prefixlines "  " }}
+---
+
+# {{.Name}} ({{.Type}})
+
+{{ .Description | trimspace }}
+
+-> If you are using a `source` block configuration, you must first have a
+connected GitHub or GitLab account connected to Cloudflare. See the
+[Getting Started with Pages] documentation on how to link your accounts.
+
+## Example Usage
+
+{{ tffile (printf "%s%s%s" "examples/resources/" .Name "/resource.tf") }}
+
+{{ .SchemaMarkdown | trimspace }}
+
+## Import
+
+Import is supported using the following syntax:
+
+{{ codefile "shell" (printf "%s%s%s" "examples/resources/" .Name "/import.sh") }}
+
+[Getting Started with Pages]: https://developers.cloudflare.com/pages/get-started/#connect-your-git-provider-to-pages