Merge pull request #278 from stackql/feature/provider-docs

snowflake updates

Author: jeffreyaven

docs/snowflake-docs/providers/snowflake/account/accounts/index.md

@@ -220,16 +220,9 @@ SELECT
 # Description fields below are for documentation purposes only and are not required in the manifest
 - name: accounts
   props:
-    - name: data__admin_name
-      value: string
-    - name: data__edition
-      value: string
-    - name: data__email
-      value: string
-    - name: data__name
-      value: string
     - name: endpoint
       value: string
+      description: Required parameter for the accounts resource.
     - name: name
       value: string
       description: >-
@@ -250,7 +243,9 @@ SELECT
         or single-tenant (for a Virtual Private Snowflake account).
     - name: edition
       value: string
-      description: Snowflake Edition of the account.
+      description: >-
+        Snowflake Edition of the account. (valid values: 'STANDARD',
+        'ENTERPRISE', 'BUSINESS_CRITICAL')
     - name: comment
       value: string
       description: Optional comment in which to store information related to the account.
@@ -280,9 +275,11 @@ SELECT
       description: >-
         Indicates whether the account administrator must change the password at
         the next login.
+      default: false
     - name: polaris
       value: boolean
       description: Indicates whether the account is a Polaris account.
+      default: false
 ```
 </TabItem>
 </Tabs>

docs/snowflake-docs/providers/snowflake/alert/alerts/index.md

@@ -204,18 +204,13 @@ SELECT
   props:
     - name: database_name
       value: string
+      description: Required parameter for the alerts resource.
     - name: schema_name
       value: string
-    - name: data__action
-      value: string
-    - name: data__condition
-      value: string
-    - name: data__name
-      value: string
-    - name: data__schedule
-      value: string
+      description: Required parameter for the alerts resource.
     - name: endpoint
       value: string
+      description: Required parameter for the alerts resource.
     - name: name
       value: string
       description: Name of the alert

docs/snowflake-docs/providers/snowflake/api_integration/api_integrations/index.md

@@ -171,24 +171,19 @@ SELECT
 # Description fields below are for documentation purposes only and are not required in the manifest
 - name: api_integrations
   props:
-    - name: data__api_allowed_prefixes
-      value: string
-    - name: data__api_hook
-      value: string
-    - name: data__enabled
-      value: string
-    - name: data__name
-      value: string
     - name: endpoint
       value: string
+      description: Required parameter for the api_integrations resource.
     - name: name
       value: string
       description: Name of the API integration.
     - name: api_hook
       value:
         - name: type
           value: string
-          description: Type of ApiHook, can be AWS, AZURE, GC or GIT.
+          description: >-
+            Type of ApiHook, can be AWS, AZURE, GC or GIT. (valid values: 'AWS',
+            'AZURE', 'GC', 'GIT')
     - name: api_allowed_prefixes
       value: array
       description: >-

docs/snowflake-docs/providers/snowflake/catalog_integration/catalog_integrations/index.md

@@ -171,27 +171,22 @@ SELECT
 # Description fields below are for documentation purposes only and are not required in the manifest
 - name: catalog_integrations
   props:
-    - name: data__catalog
-      value: string
-    - name: data__enabled
-      value: string
-    - name: data__name
-      value: string
-    - name: data__table_format
-      value: string
     - name: endpoint
       value: string
+      description: Required parameter for the catalog_integrations resource.
     - name: name
       value: string
       description: Name of the catalog integration.
     - name: catalog
       value:
         - name: catalog_source
           value: string
-          description: Type of external catalog
+          description: >-
+            Type of external catalog (valid values: 'GLUE', 'OBJECT_STORE',
+            'POLARIS')
     - name: table_format
       value: string
-      description: Table format of the catalog.
+      description: 'Table format of the catalog. (valid values: ''ICEBERG'')'
     - name: enabled
       value: boolean
       description: whether this catalog integration is available to use for Iceberg tables.

docs/snowflake-docs/providers/snowflake/compute_pool/compute_pools/index.md

@@ -225,16 +225,9 @@ SELECT
 # Description fields below are for documentation purposes only and are not required in the manifest
 - name: compute_pools
   props:
-    - name: data__instance_family
-      value: string
-    - name: data__max_nodes
-      value: string
-    - name: data__min_nodes
-      value: string
-    - name: data__name
-      value: string
     - name: endpoint
       value: string
+      description: Required parameter for the compute_pools resource.
     - name: name
       value: string
       description: >-

docs/snowflake-docs/providers/snowflake/database/databases/index.md

@@ -245,10 +245,9 @@ SELECT
 # Description fields below are for documentation purposes only and are not required in the manifest
 - name: databases
   props:
-    - name: data__name
-      value: string
     - name: endpoint
       value: string
+      description: Required parameter for the databases resource.
     - name: name
       value: string
       description: >-
@@ -257,7 +256,10 @@ SELECT
         Identifiers enclosed in double quotes are also case-sensitive.
     - name: kind
       value: string
-      description: Database type, permanent (default) or transient.
+      description: >-
+        Database type, permanent (default) or transient. (valid values:
+        'PERMANENT', 'TRANSIENT')
+      default: PERMANENT
     - name: comment
       value: string
       description: Optional comment in which to store information related to the database.

docs/snowflake-docs/providers/snowflake/database_role/database_roles/index.md

@@ -138,10 +138,10 @@ SELECT
   props:
     - name: database_name
       value: string
-    - name: data__name
-      value: string
+      description: Required parameter for the database_roles resource.
     - name: endpoint
       value: string
+      description: Required parameter for the database_roles resource.
     - name: name
       value: string
       description: Name of the database role

docs/snowflake-docs/providers/snowflake/database_role/future_grants/index.md

@@ -143,12 +143,13 @@ SELECT
   props:
     - name: database_name
       value: string
+      description: Required parameter for the future_grants resource.
     - name: name
       value: string
-    - name: data__securable_type
-      value: string
+      description: Required parameter for the future_grants resource.
     - name: endpoint
       value: string
+      description: Required parameter for the future_grants resource.
     - name: securable
       value:
         - name: database

docs/snowflake-docs/providers/snowflake/database_role/grants/index.md

@@ -143,12 +143,13 @@ SELECT
   props:
     - name: database_name
       value: string
+      description: Required parameter for the grants resource.
     - name: name
       value: string
-    - name: data__securable_type
-      value: string
+      description: Required parameter for the grants resource.
     - name: endpoint
       value: string
+      description: Required parameter for the grants resource.
     - name: securable
       value:
         - name: database

docs/snowflake-docs/providers/snowflake/dynamic_table/dynamic_tables/index.md

@@ -256,26 +256,24 @@ SELECT
   props:
     - name: database_name
       value: string
+      description: Required parameter for the dynamic_tables resource.
     - name: schema_name
       value: string
-    - name: data__name
-      value: string
-    - name: data__query
-      value: string
-    - name: data__target_lag
-      value: string
-    - name: data__warehouse
-      value: string
+      description: Required parameter for the dynamic_tables resource.
     - name: endpoint
       value: string
+      description: Required parameter for the dynamic_tables resource.
     - name: name
       value: string
       description: >-
         Specifies the name for the dynamic table, must be unique for the schema
         in which the dynamic table is created
     - name: kind
       value: string
-      description: Specifies the dynamic table type, permanent (default) or transient.
+      description: >-
+        Specifies the dynamic table type, permanent (default) or transient.
+        (valid values: 'PERMANENT', 'TRANSIENT')
+      default: PERMANENT
     - name: columns
       value:
         - name: name
@@ -295,10 +293,14 @@ SELECT
       description: Specifies the schedule for periodically refreshing the dynamic table.
     - name: refresh_mode
       value: string
-      description: Specifies the refresh type for the dynamic table
+      description: >-
+        Specifies the refresh type for the dynamic table (valid values: 'AUTO',
+        'FULL', 'INCREMENTAL')
     - name: initialize
       value: string
-      description: Specifies the behavior of the initial refresh of the dynamic table
+      description: >-
+        Specifies the behavior of the initial refresh of the dynamic table
+        (valid values: 'ON_CREATE', 'ON_SCHEDULE')
     - name: warehouse
       value: string
       description: >-