dbt-labs / dbt-labs/docs.getdbt.com

[Core] External table documentation has a mistake

Open Beginner friendly
#9,801 2 comments 1 reaction 0 assignees View on GitHub
content dbt Core
Dominant language
JavaScript
Stars
215
Forks
1.2k
Avg merge
1d 15h
Merged PRs (30d)
130

Description

### Link to the page(s) on docs.getdbt.com requiring updates

https://docs.getdbt.com/reference/resource-properties/external?version=1.11

### Tell us more about this update

In the documentation it says the `expression` should be nested under `partitions.config.meta`.

However, it should be either nested under `partitions` or `partitions.config`. So a file should look like...

```
sources:
- name:
tables:
- name:
external:
location:
file_format:
row_format:
tbl_properties:
partitions:
- name:
data_type:
description:
meta: {dictionary}
expression:
- ...
:
```

https://github.com/dbt-labs/dbt-external-tables/blob/72df97ed2019c73d7d29b306c765ad78e3d81127/macros/plugins/snowflake/create_external_table.sql#L31

### Reviewers/Stakeholders/SMEs

.

### Related GitHub issues

_No response_

### Additional information

_No response_

Contributor guide

No contributing guide indexed for this repository

Research direction

Open the external tables page at the linked docs URL and compare its `expression` nesting with the referenced `create_external_table.sql` macro. Update the documentation example and wording to show the supported nesting, then verify the rendered page matches the documented structure.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
74/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.