Documenting Column Description

Is there a way to display the column description against each column? Inside the “meta” > “column” the description is not displaying anything in data docs.

For e.g.

"last_visited": {
        "description": "Last visited date and timestamp."
      },

I understand the notes inside meta for each expectation can be rendered in the UI. But how to do it for column level (mostly as a data catalogue or data dictionary)

1 Like

This how-to guide shows how to add comments to any expectations and have them rendered in Data Docs: https://docs.greatexpectations.io/en/latest/guides/how_to_guides/configuring_data_docs/how_to_add_comments_to_expectations_and_display_them_in_data_docs.html

You can use this feature to add the description of a column. As a convention, we usually attach column description to the expect_column_to_exist expectation:

batch.expect_column_to_exist(
“brand”,
meta={
“notes”: {
“format”: “markdown”,
“content”: [
“Example notes about this column. Markdown Supported.”,
“Second example of a note about this column with Markdown”,
]
}
}
)

Please note that the comments are rendered only on the Expectation Suite pages, but not on the Validation Results ones. If this is important to you, please add +1 to this GitHub issue: Data Docs: add comments/notes to the validation results pages · Issue #1840 · great-expectations/great_expectations · GitHub

1 Like

Yes, but how do you render the column level descriptions?

+1 to following up on this thread. Is there a way to render the column descriptions, independent of packaging the description in an expectation? The reply to this thread by @eugene.mandel mentions documenting the column in an expect_column_to_exist expectation by convention. Does that mean the description from “meta” > “column” isn’t intended to be rendered in the documentation? Thanks!