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

updated snowflake

Author: jeffreyaven

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

@@ -142,7 +142,7 @@ WHERE endpoint = '{{ endpoint }}';
 ```
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>accounts</code> resource.
+Creates a account. You must provide the full account definition when creating a account.
 
 <Tabs
     defaultValue="all"
@@ -292,7 +292,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>accounts</code> resource.
+Deletes the specified account. If you enable the `ifExists` parameter, the operation succeeds even if the account does not exist. Otherwise, a 404 failure is returned if the account does not exist. if the drop is unsuccessful.
 
 ```sql
 /*+ delete */

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

@@ -132,7 +132,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>alerts</code> resource.
+Create an alert
 
 <Tabs
     defaultValue="all"
@@ -240,7 +240,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>alerts</code> resource.
+Delete an alert
 
 ```sql
 /*+ delete */

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

@@ -109,7 +109,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>api_integrations</code> resource.
+Create an API integration
 
 <Tabs
     defaultValue="all"
@@ -230,7 +230,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `DELETE` example
 
-Deletes the specified <code>api_integrations</code> resource.
+Delete an API integration
 
 ```sql
 /*+ delete */

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

@@ -111,7 +111,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>catalog_integrations</code> resource.
+Create a catalog integration.
 
 <Tabs
     defaultValue="all"
@@ -202,7 +202,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>catalog_integrations</code> resource.
+Delete a catalog integration.
 
 ```sql
 /*+ delete */

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

@@ -161,7 +161,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>compute_pools</code> resource.
+Creates a compute pool, with standard create modifiers as query parameters. See the Compute Pool component definition for what is required to be provided in the request body.
 
 <Tabs
     defaultValue="all"
@@ -291,7 +291,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `DELETE` example
 
-Deletes the specified <code>compute_pools</code> resource.
+Deletes a compute pool with the given name. If you enable the `ifExists` parameter, the operation succeeds even if the object does not exist. Otherwise, a 404 failure is returned if the object does not exist.
 
 ```sql
 /*+ delete */

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

@@ -175,7 +175,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>databases</code> resource.
+Creates a database, with modifiers as query parameters. You must provide the full database definition when creating a database.
 
 <Tabs
     defaultValue="all"
@@ -353,7 +353,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `DELETE` example
 
-Deletes the specified <code>databases</code> resource.
+Deletes the specified database. If you enable the `ifExists` parameter, the operation succeeds even if the database does not exist. Otherwise, a 404 failure is returned if the database does not exist. if the drop is unsuccessful.
 
 ```sql
 /*+ delete */

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

@@ -84,7 +84,7 @@ AND endpoint = '{{ endpoint }}';
 ```
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>database_roles</code> resource.
+Create a database role
 
 <Tabs
     defaultValue="all"
@@ -156,7 +156,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>database_roles</code> resource.
+Delete a database role
 
 ```sql
 /*+ delete */

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

@@ -79,7 +79,7 @@ AND endpoint = '{{ endpoint }}';
 ```
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>future_grants</code> resource.
+Grant future privileges to the role
 
 <Tabs
     defaultValue="all"
@@ -179,7 +179,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>future_grants</code> resource.
+Revoke future grants from the role
 
 ```sql
 /*+ delete */

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

@@ -79,7 +79,7 @@ AND endpoint = '{{ endpoint }}';
 ```
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>grants</code> resource.
+Grant privileges to the role
 
 <Tabs
     defaultValue="all"
@@ -179,7 +179,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>grants</code> resource.
+Revoke grants from the role
 
 ```sql
 /*+ delete */

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

@@ -172,7 +172,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>dynamic_tables</code> resource.
+Create a dynamic table, with standard create modifiers as query parameters. See the Dynamic Table component definition for what is required to be provided in the request body.
 
 <Tabs
     defaultValue="all"
@@ -339,7 +339,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>dynamic_tables</code> resource.
+Delete a dynamic table with the given name. If ifExists is used, the operation will succeed even if the object does not exist. Otherwise, there will be a failure if the drop is unsuccessful.
 
 ```sql
 /*+ delete */

docs/snowflake-docs/providers/snowflake/event_table/event_tables/index.md

@@ -153,7 +153,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>event_tables</code> resource.
+Create an event table
 
 <Tabs
     defaultValue="all"
@@ -263,7 +263,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>event_tables</code> resource.
+Delete an event table
 
 ```sql
 /*+ delete */

docs/snowflake-docs/providers/snowflake/external_volume/external_volumes/index.md

@@ -109,7 +109,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>external_volumes</code> resource.
+Create an external volume
 
 <Tabs
     defaultValue="all"
@@ -200,7 +200,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>external_volumes</code> resource.
+Delete an external volume
 
 ```sql
 /*+ delete */

docs/snowflake-docs/providers/snowflake/function/functions/index.md

@@ -119,7 +119,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>functions</code> resource.
+Create a function.
 
 <Tabs
     defaultValue="all"
@@ -253,7 +253,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>functions</code> resource.
+Delete a function with the given name and args.
 
 ```sql
 /*+ delete */

docs/snowflake-docs/providers/snowflake/grant/grant_options/index.md

@@ -51,7 +51,7 @@ Creates, updates, deletes, gets or lists a <code>grant_options</code> resource.
 
 ## `DELETE` example
 
-Deletes the specified <code>grant_options</code> resource.
+Endpoint to indicate that the grant option for the privilege listed in the path should be revoked.
 
 ```sql
 /*+ delete */

docs/snowflake-docs/providers/snowflake/grant/privileges/index.md

@@ -53,7 +53,7 @@ Creates, updates, deletes, gets or lists a <code>privileges</code> resource.
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>privileges</code> resource.
+Endpoint to indicate that the privileges listed in the request body should be granted.
 
 <Tabs
     defaultValue="all"
@@ -176,7 +176,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>privileges</code> resource.
+Endpoint to indicate that the privilege listed in the path should be revoked.
 
 ```sql
 /*+ delete */

docs/snowflake-docs/providers/snowflake/iceberg_table/iceberg_tables/index.md

@@ -186,7 +186,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>iceberg_tables</code> resource.
+Create a snowflake managed iceberg table (clone and undrop are separate subresources)
 
 <Tabs
     defaultValue="all"
@@ -380,7 +380,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>iceberg_tables</code> resource.
+Drop an iceberg table
 
 ```sql
 /*+ delete */

docs/snowflake-docs/providers/snowflake/image_repository/image_repositories/index.md

@@ -112,7 +112,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>image_repositories</code> resource.
+Creates an image repository in the specified database, schema, and create mode. The `createMode` query parameter specifies what action to take based on whether the repository already exists. See the ImageRepository component definition for what is required to be provided in the request body.
 
 <Tabs
     defaultValue="all"
@@ -202,7 +202,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>image_repositories</code> resource.
+Deletes an image repository with the given name. If you enable the `ifExists` query parameter, the operation succeeds even if the object does not exist. Otherwise, a 404 failure is returned if the object does not exist.
 
 ```sql
 /*+ delete */

docs/snowflake-docs/providers/snowflake/managed_account/managed_accounts/index.md

@@ -84,7 +84,7 @@ WHERE endpoint = '{{ endpoint }}';
 ```
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>managed_accounts</code> resource.
+Creates a managed account. You must provide the full managed account definition when creating a managed account.
 
 <Tabs
     defaultValue="all"
@@ -179,7 +179,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>managed_accounts</code> resource.
+Removes a managed account, including all objects created in the account, and immediately restricts access to the account. Currently used by data providers to create reader accounts for their consumers. For more details, see Manage reader accounts.
 
 ```sql
 /*+ delete */

docs/snowflake-docs/providers/snowflake/network_policy/network_policies/index.md

@@ -113,7 +113,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>network_policies</code> resource.
+Create a network policy
 
 <Tabs
     defaultValue="all"
@@ -198,7 +198,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>network_policies</code> resource.
+Delete a network policy
 
 ```sql
 /*+ delete */

docs/snowflake-docs/providers/snowflake/notebook/notebooks/index.md

@@ -182,7 +182,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>notebooks</code> resource.
+Create a notebook
 
 <Tabs
     defaultValue="all"
@@ -296,7 +296,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>notebooks</code> resource.
+Delete a notebook
 
 ```sql
 /*+ delete */

docs/snowflake-docs/providers/snowflake/notification_integration/notification_integrations/index.md

@@ -102,7 +102,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>notification_integrations</code> resource.
+Create a notification integration
 
 <Tabs
     defaultValue="all"
@@ -180,7 +180,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>notification_integrations</code> resource.
+Delete a notification integration
 
 ```sql
 /*+ delete */

docs/snowflake-docs/providers/snowflake/pipe/pipes/index.md

@@ -139,7 +139,7 @@ AND endpoint = '{{ endpoint }}';
 
 ## `INSERT` example
 
-Use the following StackQL query and manifest file to create a new <code>pipes</code> resource.
+Create a pipe
 
 <Tabs
     defaultValue="all"
@@ -255,7 +255,7 @@ SELECT
 
 ## `DELETE` example
 
-Deletes the specified <code>pipes</code> resource.
+Delete a pipe
 
 ```sql
 /*+ delete */