One prerequisite to basically all data work is to align on the specific terms and notions you'll manipulate.
Those terms have a Business definition from which derives an actual implementation. When used regularly, or in various elements, a specific implementation can be saved and shared. dbt does a great job at describing this implementation and then making it accessible in the data warehouse.
When reading notebooks (e.g. ad-hoc analyses), your colleagues would need to understand what definition you are using. And for the non-technical ones, they'll want to see the actual Business definition.
In Husprey, you can highlight some words so when users hover their mouse they will be able to see the definition and potentially access a detailed screen with more information!
To add such a definition on top of a specific term, simply select it and click on the dedicated toolbar button:
Then pick the appropriate definition or create a new one.
Here is a short demo video of how to use terms in your notebooks.
You can also access all definitions of your workspace in the dedicated "Glossary" page:
Finally, easily navigate from a definition to notebooks that mention it via the automatically generated backlinks available from each glossary pages:
Glossary brings clarity and readability to your work, and gets everyone on the same page!
Please reach out to firstname.lastname@example.org if you need any help throughout the way.
Some of you already use dedicated Data Catalogs on the side. If you'd like to see data synced with Husprey, please ping us! We are here to build the best tool Data Analysts can dream of when writing ad-hoc analyses and we want to make sure Husprey integrates perfectly with other tools from you data stack.