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

Resource types that are missing general configs

Open
#3,957 0 comments 1 reaction 0 assignees View on GitHub
content improvement
Dominant language
JavaScript
Stars
215
Forks
1.2k
Avg merge
1d 15h
Merged PRs (30d)
130

Description

### Contributions

- [X] I have read the contribution docs, and understand what's expected of me.

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

As noted in #3710, these resource types only have _properties_ pages, and they don't have _configuration_ pages:
- ❌ [analyses](https://docs.getdbt.com/reference/analysis-properties)
- ❌ [exposures](https://docs.getdbt.com/reference/exposure-properties)
- ❌ [macros](https://docs.getdbt.com/reference/macro-properties)

These resource types have neither _properties_ nor _configuration_ pages:
- ❌ metrics
- ❌ semantic models

### What part(s) of the page would you like to see updated?

There are some general configs that may be relevant:
- [`enabled`](https://docs.getdbt.com/reference/resource-configs/enabled)
- [`tags`](https://docs.getdbt.com/reference/resource-configs/tags)
- [`meta`](https://docs.getdbt.com/reference/resource-configs/meta)
- other configs?

I'd propose doing the following:
1. Testing each of the configs above for each of the resource types that are missing config pages
2. Create a config and/or properties page for each relevant resource type, and add docs for each relevant config
3. Update this [related documentation](https://docs.getdbt.com/reference/configs-and-properties#related-documentation) as appropriate to include any missing resource types and/or links

### Details
- [ ] Create a `reference/semantic-model-configs.md` page for `semantic_models`, etc. similar to:
- https://docs.getdbt.com/reference/model-configs
- https://docs.getdbt.com/reference/seed-configs
- https://docs.getdbt.com/reference/source-configs
- [x] Add appropriate links to the `website/docs/reference/resource-properties/config.md` page within the code example
- to complete the work started in [#4221](https://github.com/dbt-labs/docs.getdbt.com/pull/4221), etc.
- [x] Add any missing hyperlinks within [dbt_project.yml](https://docs.getdbt.com/reference/dbt_project.yml) page within the code example
- to complete the work started in [#4442](https://github.com/dbt-labs/docs.getdbt.com/pull/4442)

### Additional information

_No response_

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.