docs: Update repository resource examples (#133)

Add examples for the `github_repository` resource splitting up using a
template and standard usage. This also removes all of the optional
arguments from the example to align with official provider documentation
standards.

Author: craigsloggett

docs/resources/repository.md

@@ -11,35 +11,39 @@ This resource allows you to create and manage repositories within your GitHub or
 
 ## Example Usage
 
+### Standard
+
+```terraform
+resource "github_repository" "example" {
+  name = "terraform-aws-module"
+}
+```
+
+### Create from a Template
+
+Use a template to create a repository.
+
+```terraform
+resource "github_repository" "example" {
+  name = "terraform-aws-module"
+
+  template_repository = "terraform-module-template"
+}
+```
+
+### Create from a Template and Specify Owner
+
+Demonstrates creating a repository from a template owned by a different user or organization than the one configured in the provider.
+
 ```terraform
 resource "github_repository" "example" {
-  name        = "terraform-aws-module"
-  description = "A Terraform module to manage AWS infrastructure."
-
-  homepage                    = "https://github.com"
-  private                     = true
-  has_issues                  = true
-  has_projects                = true
-  has_wiki                    = true
-  has_discussions             = true
-  auto_init                   = true
-  gitignore_template          = "Terraform"
-  license_template            = "mpl-2.0"
-  allow_squash_merge          = true
-  allow_merge_commit          = true
-  allow_rebase_merge          = false
-  allow_auto_merge            = true
-  delete_branch_on_merge      = true
-  squash_merge_commit_title   = "PR_TITLE"
-  squash_merge_commit_message = "COMMIT_MESSAGES"
-  merge_commit_title          = "PR_TITLE"
-  merge_commit_message        = "PR_BODY"
-  is_template                 = true
+  name = "terraform-aws-module"
 
   template_repository = "terraform-module-template"
   template_owner      = "craigsloggett-lab"
 }
 ```
+
 <!-- schema generated by tfplugindocs -->
 ## Schema
 

examples/resources/github_repository/resource.tf

@@ -1,27 +1,3 @@
 resource "github_repository" "example" {
-  name        = "terraform-aws-module"
-  description = "A Terraform module to manage AWS infrastructure."
-
-  homepage                    = "https://github.com"
-  private                     = true
-  has_issues                  = true
-  has_projects                = true
-  has_wiki                    = true
-  has_discussions             = true
-  auto_init                   = true
-  gitignore_template          = "Terraform"
-  license_template            = "mpl-2.0"
-  allow_squash_merge          = true
-  allow_merge_commit          = true
-  allow_rebase_merge          = false
-  allow_auto_merge            = true
-  delete_branch_on_merge      = true
-  squash_merge_commit_title   = "PR_TITLE"
-  squash_merge_commit_message = "COMMIT_MESSAGES"
-  merge_commit_title          = "PR_TITLE"
-  merge_commit_message        = "PR_BODY"
-  is_template                 = true
-
-  template_repository = "terraform-module-template"
-  template_owner      = "craigsloggett-lab"
+  name = "terraform-aws-module"
 }

examples/resources/github_repository/resource_from_template.tf

@@ -0,0 +1,5 @@
+resource "github_repository" "example" {
+  name = "terraform-aws-module"
+
+  template_repository = "terraform-module-template"
+}

examples/resources/github_repository/resource_from_template_owner.tf

@@ -0,0 +1,6 @@
+resource "github_repository" "example" {
+  name = "terraform-aws-module"
+
+  template_repository = "terraform-module-template"
+  template_owner      = "craigsloggett-lab"
+}

internal/provider/repository_resource_test.go

@@ -475,6 +475,7 @@ func testAccRepositoryResourceTemplateOwnerDefaultConfig(name string) string {
 resource "github_repository" "test" {
   name                = %[1]q
   template_repository = "terraform-module-template"
+  template_owner      = "craigsloggett-lab"
 
   private         = false
   has_issues      = true

templates/resources.md.tmpl

@@ -14,6 +14,7 @@ description: |-
 
 {{codefile "terraform" .ExampleFile}}
 {{- end }}
+
 {{ .SchemaMarkdown | trimspace }}
 
 {{ if .HasImport -}}

templates/resources/repository.md.tmpl

@@ -0,0 +1,36 @@
+---
+page_title: "{{.Name}} {{.Type}} - {{.RenderedProviderName}}"
+subcategory: ""
+description: |-
+{{ .Description | plainmarkdown | trimspace | prefixlines "  " }}
+---
+
+# {{.Name}} ({{.Type}})
+
+{{ .Description | trimspace }}
+
+## Example Usage
+
+### Standard
+
+{{ tffile "examples/resources/github_repository/resource.tf" }}
+
+### Create from a Template
+
+Use a template to create a repository.
+
+{{ tffile "examples/resources/github_repository/resource_from_template.tf" }}
+
+### Create from a Template and Specify Owner
+
+Demonstrates creating a repository from a template owned by a different user or organization than the one configured in the provider.
+
+{{ tffile "examples/resources/github_repository/resource_from_template_owner.tf" }}
+
+{{ .SchemaMarkdown | trimspace }}
+
+{{ if .HasImport -}}
+## Import
+
+{{codefile "shell" .ImportFile}}
+{{- end }}