Best way to include documentation with datasets
Hi All,
I have imported a variety of datasets and built many cards for my company. I am starting to communicate these out with the rest of my company, and I anticipate other people using the datasets I have pulled in to build more cards. I would like to clearly associate documentation for each dataset (field definitions and other general information) with the dataset, not just in a text box on a dashboard. Does anyone have any best practices from similar situations? Or recommendations on how to manage the roll-out process?
Thanks so much!
Sean
Best Answers
-
Personally I'd say it depends on how much detail you want to include with the datasets. In Domo you're a little limited in that you basically have the Description field to work with to describe the overall dataset and you can tag each column in a dataset with some value. If that's enough than you can work to build that out, otherwise if you need more documentation surrounding each dataset you might want to create some sort of Data Definition Specification. I started one for some of my more popular datasets to describe each column, since unless you happen to be the admin for the system it's coming from you probably won't know the significance of every single column in the dataset. I did this in Confluence but had it in a Word doc on SharePoint previously.
Ex.
**Make sure to like any users posts that helped you and accept the ones who solved your issue.**2 -
There is also a description field for columns in the schema section of a dataset. I usually put a little description for the dataset describing what it is and briefly how it was made. It is also nice to have a dataset lineage library using the Domo Governance Datasets. We have a table with all of our dataflows along with their inputs and outputs. We have another table that shows all the datasets and the cards they power. We also have another one that shows all the column names, this might be useful if someone is looking for a certain field but they are not sure what dataset it lives in.
One thing we have done to connect documentation is by creating a documentation page that contains word docs in card form. You can then link the documentation card to the cards powered by that dataset or you could put the link to the documentation card in the dataset description.**If this answer solved your problem be sure to like it and accept it as a solution!
2
Answers
-
Personally I'd say it depends on how much detail you want to include with the datasets. In Domo you're a little limited in that you basically have the Description field to work with to describe the overall dataset and you can tag each column in a dataset with some value. If that's enough than you can work to build that out, otherwise if you need more documentation surrounding each dataset you might want to create some sort of Data Definition Specification. I started one for some of my more popular datasets to describe each column, since unless you happen to be the admin for the system it's coming from you probably won't know the significance of every single column in the dataset. I did this in Confluence but had it in a Word doc on SharePoint previously.
Ex.
**Make sure to like any users posts that helped you and accept the ones who solved your issue.**2 -
There is also a description field for columns in the schema section of a dataset. I usually put a little description for the dataset describing what it is and briefly how it was made. It is also nice to have a dataset lineage library using the Domo Governance Datasets. We have a table with all of our dataflows along with their inputs and outputs. We have another table that shows all the datasets and the cards they power. We also have another one that shows all the column names, this might be useful if someone is looking for a certain field but they are not sure what dataset it lives in.
One thing we have done to connect documentation is by creating a documentation page that contains word docs in card form. You can then link the documentation card to the cards powered by that dataset or you could put the link to the documentation card in the dataset description.**If this answer solved your problem be sure to like it and accept it as a solution!
2
Categories
- All Categories
- 1.8K Product Ideas
- 1.8K Ideas Exchange
- 1.5K Connect
- 1.2K Connectors
- 296 Workbench
- 6 Cloud Amplifier
- 8 Federated
- 2.9K Transform
- 100 SQL DataFlows
- 614 Datasets
- 2.2K Magic ETL
- 3.8K Visualize
- 2.5K Charting
- 729 Beast Mode
- 53 App Studio
- 40 Variables
- 677 Automate
- 173 Apps
- 451 APIs & Domo Developer
- 45 Workflows
- 8 DomoAI
- 34 Predict
- 14 Jupyter Workspaces
- 20 R & Python Tiles
- 394 Distribute
- 113 Domo Everywhere
- 275 Scheduled Reports
- 6 Software Integrations
- 121 Manage
- 118 Governance & Security
- Domo Community Gallery
- 32 Product Releases
- 10 Domo University
- 5.4K Community Forums
- 40 Getting Started
- 30 Community Member Introductions
- 108 Community Announcements
- 4.8K Archive