fix: clarify organization_id and add import examples (#259)

Author: JEETDESAI25

README.md

@@ -44,6 +44,7 @@ import {
 }
 
 resource "supabase_project" "production" {
+  # organization_id is your organization's slug (it can be found in the Supabase Dashboard under Organization Settings > Organization Details > Organization slug)
   organization_id   = "nknnyrtlhxudbsbuazsu"
   name              = "tf-project"
   database_password = "tf-example"

docs/resources/branch.md

@@ -49,3 +49,14 @@ Read-Only:
 - `status` (String) Status
 - `user` (String) User
 - `version` (String) Postgres version
+
+## Import
+
+Import is supported using the following syntax:
+
+The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:
+
+```shell
+# The ID is the branch identifier.
+terraform import supabase_branch.development <branch_id>
+```

docs/resources/project.md

@@ -36,7 +36,7 @@ resource "supabase_project" "test" {
 
 - `database_password` (String, Sensitive) Password for the project database
 - `name` (String) Name of the project
-- `organization_id` (String) Reference to the organization
+- `organization_id` (String) Organization slug (found in the Supabase dashboard URL or organization settings)
 - `region` (String) Region where the project is located
 
 ### Optional
@@ -46,3 +46,14 @@ resource "supabase_project" "test" {
 ### Read-Only
 
 - `id` (String) Project identifier
+
+## Import
+
+Import is supported using the following syntax:
+
+The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:
+
+```shell
+# The ID is the project reference.
+terraform import supabase_project.production <project_ref>
+```

docs/resources/settings.md

@@ -61,3 +61,14 @@ resource "supabase_settings" "production" {
 ### Read-Only
 
 - `id` (String) Project identifier
+
+## Import
+
+Import is supported using the following syntax:
+
+The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:
+
+```shell
+# The ID is the project reference.
+terraform import supabase_settings.production <project_ref>
+```

docs/schema.json

@@ -148,7 +148,7 @@
               },
               "organization_id": {
                 "type": "string",
-                "description": "Reference to the organization",
+                "description": "Organization slug (found in the Supabase dashboard URL or organization settings)",
                 "description_kind": "markdown",
                 "required": true
               },

examples/resources/supabase_branch/import.sh

@@ -0,0 +1,2 @@
+# The ID is the branch identifier.
+terraform import supabase_branch.development <branch_id>

examples/resources/supabase_project/import.sh

@@ -0,0 +1,2 @@
+# The ID is the project reference.
+terraform import supabase_project.production <project_ref>

examples/resources/supabase_settings/import.sh

@@ -0,0 +1,2 @@
+# The ID is the project reference.
+terraform import supabase_settings.production <project_ref>

internal/provider/project_resource.go

@@ -52,7 +52,7 @@ func (r *ProjectResource) Schema(ctx context.Context, req resource.SchemaRequest
 
 		Attributes: map[string]schema.Attribute{
 			"organization_id": schema.StringAttribute{
-				MarkdownDescription: "Reference to the organization",
+				MarkdownDescription: "Organization slug (found in the Supabase dashboard URL or organization settings)",
 				Required:            true,
 			},
 			"name": schema.StringAttribute{