dbt-labs / dbt-labs/docs.getdbt.com
[Core] External table documentation has a mistake
- 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