doc: Adds import block syntax and use L2 heading to show in sidebar (#2930)

* chore: Supports running from a directory that doesn't use the conventional naming

* chore: Updates docs template import statement to have correct indentation and use `import` block syntax

* chore: fix import heading level

Author: EspenAlbert

docs/resources/encryption_at_rest.md

@@ -212,7 +212,7 @@ Read-Only:
 
 - `valid` (Boolean) Flag that indicates whether the Google Cloud Key Management Service (KMS) encryption key can encrypt and decrypt data.
 
-# Import 
+## Import 
 Encryption at Rest Settings can be imported using project ID, in the format `project_id`, e.g.
 
 ```

docs/resources/encryption_at_rest_private_endpoint.md

@@ -82,7 +82,7 @@ resource "azapi_update_resource" "approval" {
 - `private_endpoint_connection_name` (String) Connection name of the Azure Private Endpoint.
 - `status` (String) State of the Encryption At Rest private endpoint.
 
-# Import 
+## Import 
 Encryption At Rest Private Endpoint resource can be imported using the project ID, cloud provider, and private endpoint ID. The format must be `{project_id}-{cloud_provider}-{private_endpoint_id}` e.g.
 
 ```

docs/resources/flex_cluster.md

@@ -90,7 +90,7 @@ Read-Only:
 - `standard` (String) Public connection string that you can use to connect to this cluster. This connection string uses the mongodb:// protocol.
 - `standard_srv` (String) Public connection string that you can use to connect to this flex cluster. This connection string uses the `mongodb+srv://` protocol.
 
-# Import 
+## Import 
 You can import the Flex Cluster resource by using the Project ID and Flex Cluster name, in the format `PROJECT_ID-FLEX_CLUSTER_NAME`. For example:
 ```
 $ terraform import mongodbatlas_flex_cluster.test 6117ac2fe2a3d04ed27a987v-yourFlexClusterName

docs/resources/mongodb_employee_access_grant.md

@@ -38,7 +38,7 @@ output "expiration_time" {
 
 **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.
 
-# Import 
+## Import 
 The resource can be imported using project ID and cluster name, in the format `PROJECTID-CLUSTERNAME`, e.g.
 
 ```

docs/resources/push_based_log_export.md

@@ -76,7 +76,7 @@ Optional:
 - `delete` (String) A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
 - `update` (String) A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
 
-# Import 
+## Import 
 Push-based log export resource can be imported using the project ID, e.g.
 
 ```

docs/resources/resource_policy.md

@@ -137,9 +137,11 @@ Read-Only:
 - `id` (String) Unique 24-hexadecimal character string that identifies a user.
 - `name` (String) Human-readable label that describes a user.
 
-# Import 
+## Import 
 Resource Policy resource can be imported using the org ID and policy ID, in the format `{ORG_ID}-{POLICY_ID}`, e.g.
 
 ```
 terraform import mongodbatlas_resource_policy.cloud_region 65def6ce0f722a1507105aa5-66f1c018dba9c04e7dcfaf36
 ```
+
+For more information see: [MongoDB Atlas API - Resource Policies](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/#tag/Resource-Policies) Documentation.

docs/resources/search_deployment.md

@@ -89,7 +89,7 @@ Optional:
 - `delete` (String) A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
 - `update` (String) A string that can be [parsed as a duration](https://pkg.go.dev/time#ParseDuration) consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
 
-# Import 
+## Import 
 Search node resource can be imported using the project ID and cluster name, in the format `PROJECT_ID-CLUSTER_NAME`, e.g.
 
 ```

docs/resources/stream_processor.md

@@ -166,7 +166,7 @@ Required:
 - `connection_name` (String) Name of the connection to write DLQ messages to. Must be an Atlas connection.
 - `db` (String) Name of the database to use for the DLQ.
 
-# Import 
+## Import 
 Stream Processor resource can be imported using the Project ID, Stream Instance name and Stream Processor name, in the format `INSTANCE_NAME-PROJECT_ID-PROCESSOR_NAME`, e.g.
 ```
 $ terraform import mongodbatlas_stream_processor.test yourInstanceName-6117ac2fe2a3d04ed27a987v-yourProcessorName

scripts/generate-docs-all.sh

@@ -34,7 +34,7 @@ export MONGODB_ATLAS_ENABLE_PREVIEW="true"
 
 trap 'rm -R docs-out/' EXIT # temp dir cleanup when script exits
 
-tfplugindocs generate --tf-version "${TF_VERSION}" --website-source-dir "${TEMPLATE_FOLDER_PATH}"  --rendered-website-dir "docs-out"
+tfplugindocs generate --tf-version "${TF_VERSION}" --website-source-dir "${TEMPLATE_FOLDER_PATH}"  --rendered-website-dir "docs-out" --provider-name "mongodbatlas"
 
 printf "\nStarting file move\n\n"
 

templates/resources.md.tmpl

@@ -62,7 +62,20 @@
 
 {{ if .SchemaMarkdown }}{{ .SchemaMarkdown | trimspace }}{{ end }}
 
-# Import 
-## Add the import
+## Import 
+
+{{.Name}} can be imported using the {PLACEHOLDER1} and {PLACEHOLDER2}, in the format `{PLACEHOLDER1}/{PLACEHOLDER2}`, e.g.
+
+**Using `terraform` CLI**
+`terraform import mongodbatlas_{{.Name}}.this {PLACEHOLDER1_EXAMPLE}-{PLACEHOLDER2_EXAMPLE}`
+
+or **Using the `import` block syntax:** (Terraform v1.5.0 and later)
+
+```terraform
+import {
+    id = "{PLACEHOLDER1_EXAMPLE}-{PLACEHOLDER2_EXAMPLE}"
+    to = mongodbatlas_{{.Name}}.this
+}
+```
 
 For more information see: [MongoDB Atlas API - Search Node](https://www.mongodb.com/docs/atlas/reference/api-resources-spec/#tag/Atlas-Search/operation/createAtlasSearchDeployment) Documentation.