Update docs with default dialect specification (#1196)

Author: treysp

docs/concepts/models/overview.md

@@ -76,7 +76,7 @@ Name is ***required*** and must be ***unique***.
 - Kind specifies what [kind](model_kinds.md) a model is. A model's kind determines how it is computed and stored. The default kind is `VIEW`, which means a view is created and your query is run each time that view is accessed. See [below](#incremental-model-properties) for properties that apply to incremental model kinds.
 
 ### dialect
-- Dialect defines the SQL dialect of the file. By default, this uses the dialect of the SQLMesh `sqlmesh.core.config`.
+- Dialect defines the SQL dialect of the model. By default, this uses the dialect in the [configuration file `model_defaults` `dialect` key](../../reference/configuration.md#model-configuration). All SQL dialects [supported by the SQLGlot library](https://github.com/tobymao/sqlglot/blob/main/sqlglot/dialects/__init__.py) are allowed.
 
 ### owner
 - Owner specifies who the main point of contact is for the model. It is an important field for organizations that have many data collaborators.

docs/guides/scheduling.md

@@ -76,7 +76,7 @@ On the client side, you must configure the connection to your Airflow cluster in
 
 Alternatively, the configuration above can be generated automatically as part of the project initialization using the `airflow` template:
 ```bash
-sqlmesh init -t airflow
+sqlmesh init [PROJECT SQL DIALECT] -t airflow
 ```
 
 For Airflow configuration types specific to Google Cloud Composer, configure the file as follows:

docs/reference/notebook.md

@@ -24,18 +24,18 @@ import sqlmesh
 
 ### Quick start project
 
-If desired, you can create the [quick start example project](../quick_start.md) with the Python `init_example_project` function:
+If desired, you can create the [quick start example project](../quick_start.md) with the Python `init_example_project` function. The function requires a default SQL dialect for the project's models; this example uses `snowflake`:
 
 ```python
 from sqlmesh.cli.example_project import init_example_project
 
-init_example_project("path_to_project_directory")
+init_example_project("path_to_project_directory", dialect="snowflake")
 ```
 
 Alternatively, create the project with a notebook magic:
 
 ```python
-%init path_to_project_directory
+%init path_to_project_directory snowflake
 ```
 
 ### Databricks notebooks
@@ -55,7 +55,7 @@ positional arguments:
 
 ## init
 ```
-%init path sql_dialect [--template TEMPLATE]
+%init path sql_dialect [--template TEMPLATE] 
 
 Creates a SQLMesh project scaffold. Argument `sql_dialect` is required unless the dbt 
 template option is specified.
@@ -78,13 +78,13 @@ options:
 
 ## plan
 ```
-%plan [--start START] [--end END] [--latest LATEST]
+%plan environment [--start START] [--end END] [--latest LATEST]
             [--create-from CREATE_FROM] [--skip-tests]
             [--restate-model [RESTATE_MODEL ...]] [--no-gaps]
             [--skip-backfill] [--forward-only]
             [--effective-from EFFECTIVE_FROM] [--no-prompts] [--auto-apply]
             [--no-auto-categorization]
-            [environment]
+            
 
 Goes through a set of prompts to both establish a plan and apply it
 
@@ -126,9 +126,8 @@ options:
 
 ## evaluate
 ```
-%evaluate [--start START] [--end END] [--latest LATEST] [--limit LIMIT]
-                model
-
+%evaluate model [--start START] [--end END] [--latest LATEST] [--limit LIMIT]
+                
 Evaluate a model query and fetches a dataframe.
 
 positional arguments:
@@ -146,9 +145,9 @@ options:
 
 ## render
 ```
-%render [--start START] [--end END] [--latest LATEST] [--expand EXPAND]
+%render model [--start START] [--end END] [--latest LATEST] [--expand EXPAND]
               [--dialect DIALECT]
-              model
+              
 
 Renders a model's query, optionally expanding referenced models.
 
@@ -181,7 +180,7 @@ positional arguments:
 
 ## test
 ```
-%test [--ls] model [test_name]
+%test model [test_name] [--ls]
 
 Allow the user to list tests for a model, output a specific test, and
 then write their changes back.