# \#documentation

**URL:** https://discourse.getdbt.com/tag/documentation/51.md

[Latest](https://discourse.getdbt.com/latest.md) · [Categories](https://discourse.getdbt.com/categories.md) · [Tags](https://discourse.getdbt.com/tags.md)

---

## [Visualise overall dataflow on system level (with DAG?)](https://discourse.getdbt.com/t/visualise-overall-dataflow-on-system-level-with-dag/20460)

<div class="topic-metadata">

**Author:** [@elva](https://discourse.getdbt.com/u/elva)\
**Replies:** 1\
**Last updated:** [December 2, 2025, 11:40am UTC](https://discourse.getdbt.com/t/visualise-overall-dataflow-on-system-level-with-dag/20460 "2025-12-02T11:40:28Z")

</div>

Hi everyone, I’m new to dbt and it’s my first post here. Hope that I don’t raise stupid question. My question is: Is it possible to modify DAG to show the upper lever instead of table level? Our business stakeholders j…

---

## [Update documentation: Names of YAML files that needs to be specifically named.](https://discourse.getdbt.com/t/update-documentation-names-of-yaml-files-that-needs-to-be-specifically-named/20157)

<div class="topic-metadata">

**Author:** [@quazirfan](https://discourse.getdbt.com/u/quazirfan)\
**Replies:** 1\
**Last updated:** [September 18, 2025, 4:38am UTC](https://discourse.getdbt.com/t/update-documentation-names-of-yaml-files-that-needs-to-be-specifically-named/20157 "2025-09-18T04:38:50Z")

</div>

At https://docs.getdbt.com/best-practices/how-we-structure/5-the-rest-of-the-project doc page it says, It’s important to note that while the top-level YAML files (dbt\_project.yml, packages.yml) need to be specifically …

---

## [Is there a way to use persist\_docs and inherited column descriptions to show field descriptions in Snowflake?](https://discourse.getdbt.com/t/is-there-a-way-to-use-persist-docs-and-inherited-column-descriptions-to-show-field-descriptions-in-snowflake/19065)

<div class="topic-metadata">

**Author:** [@amanda.wong](https://discourse.getdbt.com/u/amanda.wong)\
**Replies:** 1\
**Last updated:** [April 16, 2025, 8:39pm UTC](https://discourse.getdbt.com/t/is-there-a-way-to-use-persist-docs-and-inherited-column-descriptions-to-show-field-descriptions-in-snowflake/19065 "2025-04-16T20:39:26Z")

</div>

The problem I’m having: I can use persist\_docs to surface model and column descriptions in Snowflake but this seems to require every description field to be filled out rather than leveraging inherited column descriptions…

---

## ['doc' is undefined - when using the doc macro within a markdown file - is this expected?](https://discourse.getdbt.com/t/doc-is-undefined-when-using-the-doc-macro-within-a-markdown-file-is-this-expected/18762)

<div class="topic-metadata">

**Author:** [@rwitzel75](https://discourse.getdbt.com/u/rwitzel75)\
**Replies:** 0\
**Last updated:** [March 24, 2025, 12:32pm UTC](https://discourse.getdbt.com/t/doc-is-undefined-when-using-the-doc-macro-within-a-markdown-file-is-this-expected/18762 "2025-03-24T12:32:09Z")

</div>

The problem I’m having I cannot use the doc() macro in docs blocks. Is this intentionally? The context of why I’m trying to do this I want to modularize the documentation of the project overview, i.e. split the overview…

---

## [seed tests and documentation is missing](https://discourse.getdbt.com/t/seed-tests-and-documentation-is-missing/17786)

<div class="topic-metadata">

**Author:** [@Izaak](https://discourse.getdbt.com/u/Izaak)\
**Replies:** 1\
**Last updated:** [January 20, 2025, 1:03pm UTC](https://discourse.getdbt.com/t/seed-tests-and-documentation-is-missing/17786 "2025-01-20T13:03:31Z")

</div>

The problem I’m having I’m trying to define documentation and tests on my seeds. But I am unable to view the docs or run the tests. What I’ve already tried As per dbt-docs I’ve created a \[any\_name\].yml file in my seeds …

---

## [schema yaml for macro complaining two macros with the same name](https://discourse.getdbt.com/t/schema-yaml-for-macro-complaining-two-macros-with-the-same-name/7554)

<div class="topic-metadata">

**Author:** [@xiangshi.yin](https://discourse.getdbt.com/u/xiangshi.yin)\
**Replies:** 2\
**Last updated:** [November 14, 2024, 11:20pm UTC](https://discourse.getdbt.com/t/schema-yaml-for-macro-complaining-two-macros-with-the-same-name/7554 "2024-11-14T23:20:36Z")

</div>

The problem I’m having When adding two entries of macros in property.yml, dbt compile has the following complain: 02:17:51 Encountered an error: Compilation Error dbt found two macros named "macro2" in the project "x…

---

## [No Metadata Error, Can't Use Explore Section](https://discourse.getdbt.com/t/no-metadata-error-cant-use-explore-section/16799)

<div class="topic-metadata">

**Author:** [@patrick\_dbt](https://discourse.getdbt.com/u/patrick_dbt)\
**Replies:** 1\
**Last updated:** [October 31, 2024, 10:59pm UTC](https://discourse.getdbt.com/t/no-metadata-error-cant-use-explore-section/16799 "2024-10-31T22:59:44Z")

</div>

I am new to setting up dbt and I can’t get the ‘Explore’ section to sync with my projects. It says that I need to run a ‘Job’ in order to do this, so I did yet there still appears to be an error. Am I supposed to manua…

---

## [Generating dbt docs for multiple projects and publishing it to the github pages](https://discourse.getdbt.com/t/generating-dbt-docs-for-multiple-projects-and-publishing-it-to-the-github-pages/12674)

<div class="topic-metadata">

**Author:** [@praneeth527](https://discourse.getdbt.com/u/praneeth527)\
**Replies:** 0\
**Last updated:** [March 30, 2024, 3:36pm UTC](https://discourse.getdbt.com/t/generating-dbt-docs-for-multiple-projects-and-publishing-it-to-the-github-pages/12674 "2024-03-30T15:36:17Z")

</div>

We all faced the challenge of hosting a single website for multiple dbt projects documentation. For this I have created a GitHub action which will generate the docs for all the projects and host it in Github Pages Check…

---

## [dbt doc could’t renderize the doc block markdown table format](https://discourse.getdbt.com/t/dbt-doc-could-t-renderize-the-doc-block-markdown-table-format/9092)

<div class="topic-metadata">

**Author:** [@rahfaeu](https://discourse.getdbt.com/u/rahfaeu)\
**Replies:** 1\
**Last updated:** [February 21, 2024, 7:54am UTC](https://discourse.getdbt.com/t/dbt-doc-could-t-renderize-the-doc-block-markdown-table-format/9092 "2024-02-21T07:54:09Z")

</div>

The problem I’m having dbt doc could’t renderize the doc block markdown table format The context of why I’m trying to do this I created and reffered a doc block in table source using a markdown table format to explain e…

---

## [DBT Non-Model Documentation](https://discourse.getdbt.com/t/dbt-non-model-documentation/8615)

<div class="topic-metadata">

**Author:** [@rd144](https://discourse.getdbt.com/u/rd144)\
**Replies:** 1\
**Last updated:** [February 7, 2024, 6:44pm UTC](https://discourse.getdbt.com/t/dbt-non-model-documentation/8615 "2024-02-07T18:44:00Z")

</div>

The problem I’m having I’m trying to crate documentation for our dbt project around the standards we set for Macros/Tests/Models etc. Ideally I’d want these as an overview page under their respective folders. Is this do…

---

## [Source System Table & Field Documentation](https://discourse.getdbt.com/t/source-system-table-field-documentation/10363)

<div class="topic-metadata">

**Author:** [@JamesLarsen42](https://discourse.getdbt.com/u/JamesLarsen42)\
**Replies:** 3\
**Last updated:** [October 16, 2023, 10:32pm UTC](https://discourse.getdbt.com/t/source-system-table-field-documentation/10363 "2023-10-16T22:32:48Z")

</div>

I’m new to dbt, and am about to build a number of target models for my new company. One of the key pieces will be utilizing the documentation functionality. However, I want a place to document our source tables / field…

---

## [Exceeding dbt limits while documentation generation on DBT cloud](https://discourse.getdbt.com/t/exceeding-dbt-limits-while-documentation-generation-on-dbt-cloud/8668)

<div class="topic-metadata">

**Author:** [@wskrabalak](https://discourse.getdbt.com/u/wskrabalak)\
**Replies:** 0\
**Last updated:** [June 12, 2023, 9:26am UTC](https://discourse.getdbt.com/t/exceeding-dbt-limits-while-documentation-generation-on-dbt-cloud/8668 "2023-06-12T09:26:20Z")

</div>

The problem I’m having The context of why I’m trying to do this What I’ve already tried Some example code or error messages Put code inside backticks to preserve indentation which is especially important for…

---

## [dbt docs not showing macros?](https://discourse.getdbt.com/t/dbt-docs-not-showing-macros/8029)

<div class="topic-metadata">

**Author:** [@riolo](https://discourse.getdbt.com/u/riolo)\
**Replies:** 1\
**Last updated:** [May 5, 2023, 5:54pm UTC](https://discourse.getdbt.com/t/dbt-docs-not-showing-macros/8029 "2023-05-05T17:54:11Z")

</div>

I’ve got a .yml file (located under the macros directory) set up as described in: dbt docs generate and dbt docs serve both run without errors, but the macros don’t show up anywhere in the resulting documents. I also …

---

## [How to get upstream documentation to flow downstream (without manually updating)](https://discourse.getdbt.com/t/how-to-get-upstream-documentation-to-flow-downstream-without-manually-updating/7426)

<div class="topic-metadata">

**Author:** [@calisavage](https://discourse.getdbt.com/u/calisavage)\
**Replies:** 1\
**Last updated:** [March 22, 2023, 7:42pm UTC](https://discourse.getdbt.com/t/how-to-get-upstream-documentation-to-flow-downstream-without-manually-updating/7426 "2023-03-22T19:42:39Z")

</div>

Hi, I’m trying to create column-level documentation for staging models and would like to see that documentation populated downstream in later models when those columns are brought in using the ref() function with a docum…

---

## [Creating an ERD for your dbt project](https://discourse.getdbt.com/t/creating-an-erd-for-your-dbt-project/1436)

<div class="topic-metadata">

**Author:** [@claire](https://discourse.getdbt.com/u/claire)\
**Replies:** 8\
**Last updated:** [February 25, 2023, 4:33am UTC](https://discourse.getdbt.com/t/creating-an-erd-for-your-dbt-project/1436 "2023-02-25T04:33:58Z")

</div>

While the auto-generated documentation for your dbt project ships with a DAG view, sometimes, you really want to see an Entity Relation Diagram (ERD) of your project instead. DAG of project: The DAG shows the lineage o…

---

## [Exposure support for docs block and markdown files](https://discourse.getdbt.com/t/exposure-support-for-docs-block-and-markdown-files/5560)

<div class="topic-metadata">

**Author:** [@scanbix](https://discourse.getdbt.com/u/scanbix)\
**Replies:** 1\
**Last updated:** [December 20, 2022, 9:53am UTC](https://discourse.getdbt.com/t/exposure-support-for-docs-block-and-markdown-files/5560 "2022-12-20T09:53:43Z")

</div>

Hello, I have created an exposure and in the description field I have added doc JINJA macro to reference markdown file with more information. However, after dbt docs generate; dbt docs serve; the web page section which …

---

## [Document Dark Mode Visibility Issue](https://discourse.getdbt.com/t/document-dark-mode-visibility-issue/5220)

<div class="topic-metadata">

**Author:** [@ibozhu](https://discourse.getdbt.com/u/ibozhu)\
**Replies:** 1\
**Last updated:** [November 1, 2022, 4:04am UTC](https://discourse.getdbt.com/t/document-dark-mode-visibility-issue/5220 "2022-11-01T04:04:06Z")

</div>

I prefer dark mode when reading docs on docs.getdbt.com (in fact, I prefer dark mode everywhere). But the font colour in certain sections could really be improved, e.g. https://docs.getdbt.com/docs/build/snapshots: Dark…