Merge branch 'current' into dbeatty/copy-pasteable-commands

website/blog/2023-12-11-semantic-layer-on-semantic-layer.md

@@ -1,5 +1,5 @@
 ---
-title: "How we built consistent product launch metrics with the dbt Semantic Layer."
+title: "How we built consistent product launch metrics with the dbt Semantic Layer"
 description: "We built an end-to-end data pipeline for measuring the launch of the dbt Semantic Layer using the dbt Semantic Layer."
 slug: product-analytics-pipeline-with-dbt-semantic-layer
 

website/docs/docs/dbt-versions/release-notes/74-Dec-2023/legacy-sl.md

@@ -23,11 +23,11 @@ The [re-released dbt Semantic Layer](/docs/use-dbt-semantic-layer/dbt-sl), power
 
 ### Breaking changes and recommendations
 
-- For users on dbt version 1.6 and lower with dbt Metrics and Snowflake proxy:
+- For users on dbt version 1.5 and lower with dbt Metrics and Snowflake proxy:
   - **Impact**: Post-deprecation, queries using the proxy _will not_ run.
   - **Action required:** _Immediate_ migration is necessary. Refer to the [dbt Semantic Layer migration guide](/guides/sl-migration?step=1)
 
-- For users on dbt version 1.6 and lower using dbt Metrics without Snowflake proxy:
+- For users on dbt version 1.5 and lower using dbt Metrics without Snowflake proxy:
   - **Impact**: No immediate disruption, but the package will not receive updates or support after deprecation
   - **Recommendation**: Plan migration to the re-released Semantic Layer for compatibility with dbt version 1.6 and higher.
 

website/docs/reference/commands/deps.md

@@ -62,7 +62,11 @@ Update your versions in packages.yml, then run dbt deps
 
 dbt generates the `package-lock.yml` file in the _project_root_ where `packages.yml` is recorded, which contains all the resolved packages, the first time you run `dbt deps`. Each subsequent run records the packages installed in this file. If the subsequent `dbt deps` runs contain no updated packages in `dependencies.yml` or `packages.yml`, dbt-core installs from `package-lock.yml`. 
 
-When you update the package spec and run `dbt deps` again, the package-lock and package files update accordingly. You can run `dbt deps --lock` to update the `package-lock.yml` with the most recent dependencies from `packages`.
+When you update the package spec and run `dbt deps` again, the `package-lock.yml` and `packages.yml` files update accordingly. 
+
+There are two flags related to `package-lock.yml`:
+- `dbt deps --lock` — creates or updates the `package-lock.yml` file but does not install the packages.
+- `dbt deps --upgrade` — creates or updates the `package-lock.yml` file with the most recent dependencies from `packages.yml`. Also install the packages unless the `--lock` flag is also passed.
 
 The `--add-package` flag allows you to add a package to the `packages.yml` with configurable `--version` and `--source` information. The `--dry-run` flag, when set to `False`(default), recompiles the `package-lock.yml` file after a new package is added to the `packages.yml` file. Set the flag to `True` for the changes to not persist.