Merge branch 'current' into dbeatty10-patch-3

website/docs/docs/build/incremental-models.md

@@ -70,7 +70,7 @@ from {{ ref('app_data_events') }}
 
   -- this filter will only be applied on an incremental run
   -- (uses >= to include records whose timestamp occurred since the last run of this model)
-  where event_time >= (select max(event_time) from {{ this }})
+  where event_time >= (select coalesce(max(event_time), '1900-01-01') from {{ this }})
 
 {% endif %}
 ```
@@ -141,7 +141,7 @@ from {{ ref('app_data_events') }}
 
   -- this filter will only be applied on an incremental run
   -- (uses >= to include records arriving later on the same day as the last run of this model)
-  where date_day >= (select max(date_day) from {{ this }})
+  where date_day >= (select coalesce(max(event_time), '1900-01-01') from {{ this }})
 
 {% endif %}
 

website/docs/reference/global-configs/about-global-configs.md

@@ -73,13 +73,13 @@ Because the values of `flags` can differ across invocations, we strongly advise
 | [log_format](/reference/global-configs/logs#log-formatting) | enum | default (text) | ✅ | `DBT_LOG_FORMAT` | `--log-format` | ❌ |
 | [log_level_file](/reference/global-configs/logs#log-level) | enum | debug | ✅ | `DBT_LOG_LEVEL_FILE` | `--log-level-file` | ❌ |
 | [log_level](/reference/global-configs/logs#log-level) | enum | info | ✅ | `DBT_LOG_LEVEL` | `--log-level` | ❌ |
-| [log_path](/reference/global-configs/logs) | path | None (uses `logs/`) | ❌ | `DBT_PROFILES_DIR` | `--profiles-dir` | ❌ |
+| [log_path](/reference/global-configs/logs) | path | None (uses `logs/`) | ❌ | `DBT_LOG_PATH` | `--profiles-dir` | ❌ |
 | [partial_parse](/reference/global-configs/parsing#partial-parsing) | boolean | True | ✅ | `DBT_PARTIAL_PARSE` | `--partial-parse`, `--no-partial-parse` | ✅ |
 | [populate_cache](/reference/global-configs/cache) | boolean | True | ✅ | `DBT_POPULATE_CACHE` | `--populate-cache`, `--no-populate-cache` | ✅ |
 | [print](/reference/global-configs/print-output#suppress-print-messages-in-stdout) | boolean | True | ❌ | `DBT_PRINT` | `--print` | ❌ |
 | [printer_width](/reference/global-configs/print-output#printer-width) | int | 80 | ✅ | `DBT_PRINTER_WIDTH` | `--printer-width` | ❌ |
 | [profile](/docs/core/connect-data-platform/connection-profiles#about-profiles) | string | None | ✅ (as top-level key) | `DBT_PROFILE`  | `--profile` | ❌ |
-| [profiles_dir](/docs/core/connect-data-platform/connection-profiles#about-profiles) | path | None (current dir, then HOME dir) | ❌ | `DBT_PROFILES_DIR` | `--profiles-dir` | ❌ |
+| [profiles_dir](/docs/core/connect-data-platform/connection-profiles#about-profiles) | path | None (current dir, then HOME dir) | ❌ | `DBT_PROFILES_DIR` | `--log-path` | ❌ |
 | [project_dir](/reference/dbt_project.yml) | path |  | ❌ | `DBT_PROJECT_DIR` | `--project-dir` | ❌ |
 | [quiet](/reference/global-configs/logs#suppress-non-error-logs-in-output) | boolean | False | ❌ | `DBT_QUIET` | `--quiet` | ✅ |
 | [resource-type](/reference/global-configs/resource-type) (v1.8+) | string | None | ❌ | `DBT_RESOURCE_TYPES` <br></br> `DBT_EXCLUDE_RESOURCE_TYPES` | `--resource-type` <br></br> `--exclude-resource-type` | ✅ |

website/docs/reference/node-selection/graph-operators.md

@@ -3,13 +3,13 @@ title: "Graph operators"
 ---
 
 ### The "plus" operator
-If placed at the front of the model selector, `+` will select all parents of the selected model and the model itself. If placed at the end of the string, `+` will select all children of the selected model and the model itself.
+If placed at the front of the model selector, `+` will select all ancestors of the selected model and the model itself. If placed at the end of the string, `+` will select all descendants of the selected model and the model itself.
 
 
    ```bash
-dbt run --select "my_model+"         # select my_model and all children
-dbt run --select "+my_model"         # select my_model and all parents
-dbt run --select "+my_model+"        # select my_model, and all of its parents and children
+dbt run --select "my_model+"         # select my_model and all descendants
+dbt run --select "+my_model"         # select my_model and all ancestors
+dbt run --select "+my_model+"        # select my_model, and all of its ancestors and descendants
   ```
 
 
@@ -20,17 +20,19 @@ to step through.
 
 
   ```bash
-dbt run --select "my_model+1"        # select my_model and its first-degree children
-dbt run --select "2+my_model"        # select my_model, its first-degree parents, and its second-degree parents ("grandparents")
-dbt run --select "3+my_model+4"      # select my_model, its parents up to the 3rd degree, and its children down to the 4th degree
+dbt run --select "my_model+1"        # select my_model and its first-degree descendants
+dbt run --select "2+my_model"        # select my_model, its first-degree ancestors ("parents"), and its second-degree ancestors ("grandparents")
+dbt run --select "3+my_model+4"      # select my_model, its ancestors up to the 3rd degree, and its descendants down to the 4th degree
   ```
 
 
 ### The "at" operator
-The `@` operator is similar to `+`, but will also include _the parents of the children of the selected model_. This is useful in continuous integration environments where you want to build a model and all of its children, but the _parents_ of those children might not exist in the database yet. The selector `@snowplow_web_page_context` will build all three models shown in the diagram below.
+The `@` operator is similar to `+`, but will also include _all ancestors of all descendants of the selected model_. This is useful in continuous integration environments where you want to build a model and all of its descendants, but the _ancestors_ of those descendants might not exist in the schema yet. The `@` operator (which can only be placed at the front of the model name) will select as many degrees of ancestors ("parents," "grandparents," and so on) as is needed to successfully build all descendants of the specified model. 
+
+The selector `@snowplow_web_page_context` will build all three models shown in the diagram below.
 
 <Lightbox src="/img/docs/running-a-dbt-project/command-line-interface/1643e30-Screen_Shot_2019-03-11_at_7.18.20_PM.png" title="@snowplow_web_page_context will select all of the models shown here"/>
 
 ```bash
-dbt run --models @my_model           # select my_model, its children, and the parents of its children
+dbt run --select "@my_model"         # select my_model, its descendants, and the ancestors of its descendants
 ```