move to templates

Author: matifali

docs/guides/v1-to-v2-migration.md

@@ -42,6 +42,4 @@ If you are using the `owner` properties of the `coder_workspace` data source, yo
 | `data.coder_workspace.me.owner_oidc_access_token` | `data.coder_workspace_owner.me.oidc_access_token` |
 | `data.coder_workspace.me.owner_session_token` | `data.coder_workspace_owner.me.session_token` |
 
-```terraform
-
 ->While we do not anticipate these changes to affect existing resources, we strongly advice reviewing the plan produced by Terraform to ensure no resources are accidentally removed or altered in an undesired way. If you encounter any unexpected behavior, please report it by opening a GitHub [issue](https://github.com/coder/terraform-provider-coder/issues).

docs/index.md

@@ -3,6 +3,7 @@
 page_title: "Coder Provider"
 subcategory: "Infrastructure"
 description: |-
+    Terraform provider for Coder. Coder is a self-hosted cloud development environment that allows enterprises to create consistent, secure, and scalable development environments for their teams.
   
 ---
 
@@ -12,7 +13,7 @@ The Coder provider is used to help create [Coder](https://coder.com) templates.
 
 -> Requires Coder v2.13.0 or later.
 
-!> `coder_git_auth` and owner related fields of `coder_workspace` data source have been removed. Follow the [v0 to v1migration guide](https://registry.terraform.io/providers/codercom/coder/latest/docs/guides/v0-to-v1-migration) to update your code.
+!> `coder_git_auth` and owner related fields of `coder_workspace` data source have been removed. Follow the [v0 to v1migration guide](https://registry.terraform.io/providers/codercom/coder/latest/docs/guides/v1-to-v2-migration) to update your code.
 
 ## Example
 

templates/guides/v1-to-v2-migration.md.tmpl

@@ -0,0 +1,45 @@
+---
+page_title: "Migrate from v1 to v2"
+---
+
+# Migrate from v1 to v2
+
+Version 2.0.0 of the Coder provider for Terraform is a major release that removes the following deprecated data sources and their properties:
+
+- `coder_git_auth` data source
+- All owner properties from the [`coder_workspace`](../docs/data-sources/workspace.md) data source
+
+## Migrating `coder_git_auth` data source
+
+If you are using this data source, you must replace it with the [`coder_external_auth`](../docs/data-sources/external-auth.md) data source. The `coder_external_auth` data source is a more generic data source that can be used to create any external authentication provider.
+
+### v1.0.0
+```terraform
+
+data "coder_git_auth" "example" {
+  id = "example"
+}
+```
+### v2.0.0
+```terraform
+data "coder_external_auth" "example" {
+  id = "example"
+}
+```
+
+
+## Migrating `coder_workspace` data source
+
+If you are using the `owner` properties of the `coder_workspace` data source, you must remove them and use the `coder_workspace_owner` data source instead. The `coder_workspace_owner` data source is a more generic data source that provide additional properties of the workspace owner.
+
+| `v1.0.0` | `v2.0.0` |
+|-----------|----------|
+| `data.coder_workspace.me.owner_id` | `data.coder_workspace_owner.me.id` |
+| `data.coder_workspace.me.owner` | `data.coder_workspace_owner.me.name` |
+| `data.coder_workspace.me.owner_name` | `data.coder_workspace_owner.me.full_name` |
+| `data.coder_workspace.me.owner_email` | `data.coder_workspace_owner.me.email` |
+| `data.coder_workspace.me.owner_groups` | `data.coder_workspace_owner.me.groups` |
+| `data.coder_workspace.me.owner_oidc_access_token` | `data.coder_workspace_owner.me.oidc_access_token` |
+| `data.coder_workspace.me.owner_session_token` | `data.coder_workspace_owner.me.session_token` |
+
+->While we do not anticipate these changes to affect existing resources, we strongly advice reviewing the plan produced by Terraform to ensure no resources are accidentally removed or altered in an undesired way. If you encounter any unexpected behavior, please report it by opening a GitHub [issue](https://github.com/coder/terraform-provider-coder/issues).