docs: deprecate dbt metrics package (#6542)

* docs: deprecate dbt metrics package

* Edit

---------

Co-authored-by: Igor Lukanin <[email protected]>

Author: keydunov

docs/content/Schema/Advanced/Using-dbt.mdx

@@ -6,76 +6,32 @@ subCategory: Advanced
 menuOrder: 35
 ---
 
-<InfoBox>
+You can leverage Cube on top of dbt models by pointing cubes to dbt models in your database.
 
-This functionality only works with models written in JavaScript, not YAML.
+<CodeTabs>
 
-</InfoBox>
-
-Cube's metrics layer is able to read metrics definitions from [dbt][dbt] via the
-[Metadata API][dbt-docs-metadata-api] and translate them into an equivalent Cube
-data model.
-
-## Connect dbt Core to Cube
-
-This can be done through reading the `dbt-project.yml` file.
-
-```javascript
-import dbt from '@cubejs-backend/dbt-schema-extension';
-
-asyncModule(async () => {
-  // `/dbt` is the path to a folder containing `dbt-project.yml`
-  await dbt.loadMetricCubesFromDbtProject('/dbt');
-});
-```
-
-## Connect dbt Cloud to Cube
-
-Create a `config.js` file as a sibling to the `model/` folder in your Cube
-project:
-
-```javascript
-exports.dbtJobId = 65806;
-exports.dbtApiKey = 'YOUR_KEY_HERE';
+```yaml
+cubes:
+  - name: orders
+  - sql_table: my_dbt_schema.my_dbt_orders_model
 ```
 
-Create a file called `dbt.js` in the `model/` folder and enter the following
-code snippet:
-
 ```javascript
-import dbt from '@cubejs-backend/dbt-schema-extension';
-import { dbtJobId, dbtApiKey } from '../config';
-
-asyncModule(async () => {
-  await dbt.loadMetricCubesFromDbtCloud(dbtJobId, dbtApiKey);
+cube(`orders`, {
+  sql_table: `my_dbt_schema.my_dbt_orders_model`
 });
 ```
 
-You can then define cubes under the above snippet:
+</CodeTabs>
 
-```javascript
-import dbt from '@cubejs-backend/dbt-schema-extension';
-import { dbtJobId, dbtApiKey } from '../config';
+## Using dbt_metrics
 
-asyncModule(async () => {
-  await dbt.loadMetricCubesFromDbtCloud(dbtJobId, dbtApiKey);
-});
+<WarningBox>
 
-cube('GithubCommitStatsCommitsCached', {
-  extends: GithubCommitStatsCommits,
+Previously, Cube provided the `@cubejs-backend/dbt-schema-extension` package to read metric definitions from dbt.
+Due to the [change in direction][dbt-deprecation] at dbt, we have deprecated this package as well.
+When a new `dbt_metrics` package becomes available, we will update and reintroduce our integration.
 
-  preAggregations: {
-    main: {
-      measures: [commitsCount],
-      dimensions: [authorDomain, authorName],
-      timeDimension: timestamp,
-      granularity: 'day',
-      partitionGranularity: 'year',
-    },
-  },
-});
-```
+</WarningBox>
 
-[dbt]: https://www.getdbt.com/
-[dbt-docs-metadata-api]:
-  https://docs.getdbt.com/docs/dbt-cloud-apis/metadata-api
+[dbt-deprecation]: https://docs.getdbt.com/blog/deprecating-dbt-metrics