# How to get 'stable' URL for documentation?

**URL:** https://discourse.julialang.org/t/how-to-get-stable-url-for-documentation/64030
**Category:** New to Julia
**Tags:** documenter
**Created:** [July 4, 2021, 11:08am UTC](https://discourse.julialang.org/t/how-to-get-stable-url-for-documentation/64030 "2021-07-04T11:08:34Z")
**Posts on this page:** 7
**Page:** 1

<div class="post-metadata">

### Author: ![MattWillFlood](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mattwillflood/32/20722_2.png) [@MattWillFlood](https://discourse.julialang.org/u/MattWillFlood)
#### Post date: [July 4, 2021, 11:08am UTC](https://discourse.julialang.org/t/how-to-get-stable-url-for-documentation/64030/1 "2021-07-04T11:08:34Z")

</div>

According to the [documentation for Documenter.jl](https://juliadocs.github.io/Documenter.jl/stable/man/hosting/#Documentation-Versions):

> - Documentation built for a tag `vX.Y.Z` will be stored in a folder `vX.Y.Z` .
> - Documentation built from the `devbranch` branch ( `master` by default) is stored in a folder determined by the `devurl` keyword to [`deploydocs`](https://juliadocs.github.io/Documenter.jl/stable/lib/public/#Documenter.deploydocs) ( `dev` by default).

Can somebody please explain how to build documentation for a specific tagged version?

I’ve built [documentation for a package](https://mattwillflood.github.io/EntropyHub.jl/dev/) which has a release version v0.1.1, but because the docs come from the ‘master’ branch on git, I can only see the `dev` URL on the github pages hosted site…  
I’ve seen that other packages have folders marked with the version number on the ‘gh-pages’ branch where the tagged documentation is pulled from, but I don’t understand how I can create such a folder 🤷🏻‍♂️.

Any help would be much appreciated 🙏🏾

---

<div class="post-metadata">

### Author: ![kimikage](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kimikage/32/14534_2.png) [@kimikage](https://discourse.julialang.org/u/kimikage)
#### Post date: [July 4, 2021, 2:12pm UTC](https://discourse.julialang.org/t/how-to-get-stable-url-for-documentation/64030/2 "2021-07-04T14:12:55Z")

</div>

Doesn’t the “Fixing broken release deployments” in your link work well?

---

<div class="post-metadata">

### Author: ![mortenpi](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mortenpi/32/158_2.png) [@mortenpi](https://discourse.julialang.org/u/mortenpi)
#### Post date: [July 4, 2021, 10:18pm UTC](https://discourse.julialang.org/t/how-to-get-stable-url-for-documentation/64030/3 "2021-07-04T22:18:10Z")

</div>

Your [documentation workflow](https://github.com/MattWillFlood/EntropyHub.jl/blob/master/.github/workflows/Documentation.yml) is not running for tags as far as I can tell. My hunch is that [the culprit is the `GITHUB_TOKEN` permission issue with TagBot](https://github.com/JuliaRegistries/TagBot#ssh-deploy-keys), although I do not see anything actually wrong with your setup.

---

<div class="post-metadata">

### Author: ![lmiq](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/lmiq/32/18314_2.png) [@lmiq](https://discourse.julialang.org/u/lmiq)
#### Post date: [July 4, 2021, 11:04pm UTC](https://discourse.julialang.org/t/how-to-get-stable-url-for-documentation/64030/4 "2021-07-04T23:04:15Z")

</div>

Here is a step by step that might be helpful:[Publish Docs · JuliaNotes.jl](https://m3g.github.io/JuliaNotes.jl/stable/publish_docs/)

---

<div class="post-metadata">

### Author: ![rafael.guerra](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/rafael.guerra/32/216610_2.png) [@rafael.guerra](https://discourse.julialang.org/u/rafael.guerra)
#### Post date: [July 5, 2021, 7:16am UTC](https://discourse.julialang.org/t/how-to-get-stable-url-for-documentation/64030/5 "2021-07-05T07:16:13Z")

</div>

@lmiq, thanks and btw, who is Christopher in your notes?

---

<div class="post-metadata">

### Author: ![lmiq](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/lmiq/32/18314_2.png) [@lmiq](https://discourse.julialang.org/u/lmiq)
#### Post date: [July 5, 2021, 9:44am UTC](https://discourse.julialang.org/t/how-to-get-stable-url-for-documentation/64030/6 "2021-07-05T09:44:53Z")

</div>

> [@rafael.guerra](#):
>
> and btw, who is Christopher in your notes?

> [@Latest version of docs not published (github actions/TagBot)](https://discourse.julialang.org/t/latest-version-of-docs-not-published-github-actions-tagbot/50634/25):
>
> Yeah, this was super annoying for a long time. It’s fixed now though, you can put whatever garbage whitespace you’d like into your keys slight_smile

---

<div class="post-metadata">

### Author: ![MattWillFlood](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/mattwillflood/32/20722_2.png) [@MattWillFlood](https://discourse.julialang.org/u/MattWillFlood)
#### Post date: [July 5, 2021, 8:19pm UTC](https://discourse.julialang.org/t/how-to-get-stable-url-for-documentation/64030/7 "2021-07-05T20:19:59Z")

</div>

So I managed to resolve the issue…

(Please excuse my crude amateur explanation 🙄)  
I built the docs for this package long before registering the package in the general registry.  
So in my local git GUI, the tagged versions of the package only appear as tagged versions since registering.  
I went back to the last commit with an associated tag, and re-pushed it to the master branch.  
That seemed to trigger the documentation to create the new version folder in the gh-pages branch, as well as the stable folder.

This is probably the same/similar process as suggested by @lmiq.

Is it me or does this seem to be a somewhat common issue?  
There’s probably a simple reason why I couldn’t get it to work in the first place (most likely something stupid I did), but as @mortenpi has clarified, the workflow seems ok…  
🤷🏻‍♂️

Thanks for the support! 🙂 😇
