chore: Add preview and stable categories to resources and data source…

…s in docs (#3370)

<!-- Feel free to delete comments as you fill this in -->
- Group stable and preview resources and data sources in docs.
- Adjust a few descriptions regarding preview status.
<!-- summary of changes -->

## Test Plan
<!-- detail ways in which this PR has been tested or needs to be tested
-->
* [ ] acceptance tests
<!-- add more below if you think they are relevant -->
* [ ] …

## References
<!-- issues documentation links, etc  -->

MIGRATION_GUIDE.md

@@ -7,6 +7,12 @@ across different versions.
 > [!TIP]
 > We highly recommend upgrading the versions one by one instead of bulk upgrades.
 
+## v1.0.2 ➞ v1.0.3
+
+### Changed documentation structure
+We added `Preview` and `Stable` categories to the resources and data sources documentation, which clearly separates the preview and stable features in the documentation feature list.
+This is a part of our effort to improve the provider documentation. We are open for your feedback and suggestions.
+
 ## v1.0.1 ➞ v1.0.2
 
 ### Fixed migration of account resource

docs/data-sources/account_roles.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_account_roles Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered account roles. Filtering is aligned with the current possibilities for SHOW ROLES https://docs.snowflake.com/en/sql-reference/sql/show-roles query (like and in_class are all supported). The results of SHOW are encapsulated in one output collection.
 ---

docs/data-sources/accounts.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_accounts Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered accounts. Filtering is aligned with the current possibilities for SHOW ACCOUNTS https://docs.snowflake.com/en/sql-reference/sql/show-accounts query. The results of SHOW are encapsulated in one output collection accounts.
 ---

docs/data-sources/alerts.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_alerts Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/connections.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_connections Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered connections. Filtering is aligned with the current possibilities for SHOW CONNECTIONS https://docs.snowflake.com/en/sql-reference/sql/show-connections query. The results of SHOW is encapsulated in one output collection connections.
 ---

docs/data-sources/cortex_search_services.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_cortex_search_services Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/current_account.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_current_account Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/current_role.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_current_role Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/database.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_database Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/database_role.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_database_role Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/database_roles.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_database_roles Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered database roles. Filtering is aligned with the current possibilities for SHOW DATABASE ROLES https://docs.snowflake.com/en/sql-reference/sql/show-database-roles query (like and limit are supported). The results of SHOW is encapsulated in show_output collection.
 ---

docs/data-sources/databases.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_databases Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered databases. Filtering is aligned with the current possibilities for SHOW DATABASES https://docs.snowflake.com/en/sql-reference/sql/show-databases query (like, starts_with, and limit are all supported). The results of SHOW, DESCRIBE, and SHOW PARAMETERS IN are encapsulated in one output collection.
 ---

docs/data-sources/dynamic_tables.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_dynamic_tables Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/external_functions.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_external_functions Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/external_tables.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_external_tables Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/failover_groups.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_failover_groups Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/file_formats.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_file_formats Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/functions.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_functions Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/grants.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_grants Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   
 ---

docs/data-sources/masking_policies.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_masking_policies Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered masking policies. Filtering is aligned with the current possibilities for SHOW MASKING POLICIES https://docs.snowflake.com/en/sql-reference/sql/show-masking-policies query. The results of SHOW and DESCRIBE are encapsulated in one output collection masking_policies.
 ---

docs/data-sources/materialized_views.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_materialized_views Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/network_policies.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_network_policies Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered network policies. Filtering is aligned with the current possibilities for SHOW NETWORK POLICIES https://docs.snowflake.com/en/sql-reference/sql/show-network-policies query (like is supported). The results of SHOW and DESCRIBE are encapsulated in one output collection.
 ---

docs/data-sources/parameters.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_parameters Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/pipes.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_pipes Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/procedures.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_procedures Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/resource_monitors.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_resource_monitors Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered resource monitors. Filtering is aligned with the current possibilities for SHOW RESOURCE MONITORS https://docs.snowflake.com/en/sql-reference/sql/show-resource-monitors query (like is supported). The results of SHOW is encapsulated in show_output collection.
 ---

docs/data-sources/row_access_policies.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_row_access_policies Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered row access policies. Filtering is aligned with the current possibilities for SHOW ROW ACCESS POLICIES https://docs.snowflake.com/en/sql-reference/sql/show-row-access-policies query. The results of SHOW and DESCRIBE are encapsulated in one output collection row_access_policies.
 ---

docs/data-sources/schemas.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_schemas Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered schemas. Filtering is aligned with the current possibilities for SHOW SCHEMAS https://docs.snowflake.com/en/sql-reference/sql/show-schemas query. The results of SHOW, DESCRIBE, and SHOW PARAMETERS IN are encapsulated in one output collection.
 ---

docs/data-sources/secrets.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_secrets Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered secrets. Filtering is aligned with the current possibilities for SHOW SECRETS https://docs.snowflake.com/en/sql-reference/sql/show-secrets query. The results of SHOW and DESCRIBE are encapsulated in one output collection secrets.
 ---

docs/data-sources/security_integrations.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_security_integrations Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered security integrations. Filtering is aligned with the current possibilities for SHOW SECURITY INTEGRATIONS https://docs.snowflake.com/en/sql-reference/sql/show-integrations query (only like is supported). The results of SHOW and DESCRIBE are encapsulated in one output collection security_integrations.
 ---

docs/data-sources/sequences.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_sequences Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/shares.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_shares Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/stages.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_stages Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/storage_integrations.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_storage_integrations Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/streamlits.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_streamlits Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered streamlits. Filtering is aligned with the current possibilities for SHOW STREAMLITS https://docs.snowflake.com/en/sql-reference/sql/show-streamlits query (only like is supported). The results of SHOW and DESCRIBE are encapsulated in one output collection streamlits.
 ---

docs/data-sources/streams.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_streams Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered streams. Filtering is aligned with the current possibilities for SHOW STREAMS https://docs.snowflake.com/en/sql-reference/sql/show-streams query. The results of SHOW and DESCRIBE are encapsulated in one output collection streams.
 ---

docs/data-sources/system_generate_scim_access_token.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_system_generate_scim_access_token Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/system_get_aws_sns_iam_policy.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_system_get_aws_sns_iam_policy Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/system_get_privatelink_config.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_system_get_privatelink_config Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/system_get_snowflake_platform_info.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_system_get_snowflake_platform_info Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/tables.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_tables Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   
 ---

docs/data-sources/tags.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_tags Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered tags. Filtering is aligned with the current possibilities for SHOW TAGS https://docs.snowflake.com/en/sql-reference/sql/show-tags query. The results of SHOW are encapsulated in one output collection tags.
 ---

docs/data-sources/tasks.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_tasks Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered tasks. Filtering is aligned with the current possibilities for SHOW TASKS https://docs.snowflake.com/en/sql-reference/sql/show-tasks query. The results of SHOW and SHOW PARAMETERS IN are encapsulated in one output collection tasks.
 ---

docs/data-sources/users.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_users Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered users. Filtering is aligned with the current possibilities for SHOW USERS https://docs.snowflake.com/en/sql-reference/sql/show-users query. The results of SHOW, DESCRIBE, and SHOW PARAMETERS IN are encapsulated in one output collection. Important note is that when querying users you don't have permissions to, the querying options are limited. You won't get almost any field in show_output (only empty or default values), the DESCRIBE command cannot be called, so you have to set with_describe = false. Only parameters output is not affected by the lack of privileges.
 ---

docs/data-sources/views.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_views Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered views. Filtering is aligned with the current possibilities for SHOW VIEWS https://docs.snowflake.com/en/sql-reference/sql/show-views query (only like is supported). The results of SHOW and DESCRIBE are encapsulated in one output collection views.
 ---

docs/data-sources/warehouses.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_warehouses Data Source - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   Data source used to get details of filtered warehouses. Filtering is aligned with the current possibilities for SHOW WAREHOUSES https://docs.snowflake.com/en/sql-reference/sql/show-warehouses query (only like is supported). The results of SHOW, DESCRIBE, and SHOW PARAMETERS IN are encapsulated in one output collection.
 ---

docs/resources/account.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_account Resource - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Stable"
 description: |-
   The account resource allows you to create and manage Snowflake accounts. For more information, check account documentation https://docs.snowflake.com/en/user-guide/organizations-manage-accounts.
 ---

docs/resources/account_authentication_policy_attachment.md

@@ -1,6 +1,6 @@
 ---
 page_title: "snowflake_account_authentication_policy_attachment Resource - terraform-provider-snowflake"
-subcategory: ""
+subcategory: "Preview"
 description: |-
   Specifies the authentication policy to use for the current account. To set the authentication policy of a different account, use a provider alias.
 ---