11/04/2021, 1:37 PM
Hello Everyone. I have a question about documentation best practices. The autogenerated documentation is great to focus on pipelines and package but i would like also to document more my datasets. (I generated a static site on github pages) What would be the best approach to add details about datasources (meaning, content .. )? The data catalog could be a good place to start but the yaml file doesn't gives us access to description fields or other things like this (or maybe i missed something). (Or it's simply not the right place to write such piece of information.) Should i add details in a custom part of the sphinx project or could it be incorporated somewhere else ? What are you used to do when documenting your datasources?