Each time dbt jobs are rerun on dbt Cloud, project documentation is updated. However, to access that documentation, you have to go each time via login page. It is because on each dbt job run documentation URL changes with different run ID.
Example URL which keeps changing
It would be nice to have permanent URL which always points to the latest version of project documentation in dbt cloud. This would allow to permanently link to model documentation from outside sources, like wiki pages, intranet resources.
Good example is GitHub URL to download latest software release. Internally its a new commit, but that latest version is accessible via permanent URL:
There’s two ways you can get a dbt Docs URL from dbt Cloud:
- A run-specific link, like this:
- A job-specific link, like this:
The first one does change from run to run, but the second stays static (unless you change which job is responsible for generating documentation in your Artifacts settings).
What’s surprising to me is that the example link you provide is a job-focused one, so I’m not sure why you’re seeing that the run ID keeps changing. Could you double-check that you pasted the right type of link?
Your explanation might resolve this small problem for now. Until the job, refreshing documentation is recreated/redeployed.
However, I would like put an improvement, that each project would have permanent, user-friendly like in GitHub URL to the latest documentation independent of job ID ir run ID.
Agreed! I’ll bump that suggestion internally.
This topic was automatically closed 7 days after the last reply. New replies are no longer allowed.