# Lost in documentation deployment on Github

**URL:** https://discourse.julialang.org/t/lost-in-documentation-deployment-on-github/131668
**Category:** Package Management
**Tags:** question
**Created:** [August 18, 2025, 5:01am UTC](https://discourse.julialang.org/t/lost-in-documentation-deployment-on-github/131668 "2025-08-18T05:01:56Z")
**Posts on this page:** 4
**Page:** 1

<div class="post-metadata">

### Author: ![nicolas](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/nicolas/32/26439_2.png) [@nicolas](https://discourse.julialang.org/u/nicolas)
#### Post date: [August 18, 2025, 5:01am UTC](https://discourse.julialang.org/t/lost-in-documentation-deployment-on-github/131668/1 "2025-08-18T05:01:56Z")

</div>

In 2021, I created the package [GitHub - NicolasL-S/SpeedMapping.jl: General fixed point mapping acceleration and optimization in Julia](https://github.com/NicolasL-S/SpeedMapping.jl)  
I finally got some time to update it. I created a branch “MajorRefactor” to make all the changes and successfully deployed the documentation on [Introduction · SpeedMapping.jl](https://nicolasl-s.github.io/SpeedMapping.jl/dev/). Earlier today, I merged MajorRefactor back on main, hoping that deploying the documentation on [Home · SpeedMapping.jl](https://nicolasl-s.github.io/SpeedMapping.jl/stable/) would be as easy as it was on dev. Yet, no matter my efforts, nothing seems to work. What’s worse, after trying many different things, including creating a package new version, both the stable and dev have disappeared. The puzzling part is that I hardly get any error message while building the doc. Help would be greatly appreciated!

---

<div class="post-metadata">

### Author: ![jling](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/jling/32/212909_2.png) [@jling](https://discourse.julialang.org/u/jling)
#### Post date: [August 18, 2025, 5:07am UTC](https://discourse.julialang.org/t/lost-in-documentation-deployment-on-github/131668/2 "2025-08-18T05:07:25Z")

</div>

after [Delete Documentation.yml · NicolasL-S/SpeedMapping.jl@c15c0d1 · GitHub](https://github.com/NicolasL-S/SpeedMapping.jl/commit/c15c0d168f340cbe202c132d2e05b48e78bd3758) there’s no CI building docs at all?

> <https://github.com/JuliaData/DataFrames.jl/blob/48563e3253d482fdcb64aeaca18b0fb806418f1c/.github/workflows/ci.yml#L48-L58>

building & deploy docs should be really simple now.

Follow this [Hosting Documentation · Documenter.jl](https://documenter.juliadocs.org/stable/man/hosting/#GitHub-Actions)

---

<div class="post-metadata">

### Author: ![nicolas](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/nicolas/32/26439_2.png) [@nicolas](https://discourse.julialang.org/u/nicolas)
#### Post date: [August 29, 2025, 1:40am UTC](https://discourse.julialang.org/t/lost-in-documentation-deployment-on-github/131668/3 "2025-08-29T01:40:44Z")

</div>

Thanks a lot for your help. Yes, build actions were missing; I had tried many things and after the last, I forgot to put them back.

Now I think something is very wrong with the repo. In pages, I see this:

 ![image](https://global.discourse-cdn.com/julialang/original/3X/c/b/cbd0d04b0f3033b9ce4dfab5f291fecb440326ea.png)

but my actions are set to Allow all actions and reusable workflows. I opened a ticket on Github’s support, but they said I needed a paid GitHub plan, Copilot Business, or Copilot Enterprise, which I obviously don’t.

In the end, the only way I saw to fix the problem was to create a new repo just to deploy the docs:  
[https://nicolasl-s.github.io/SpeedMappingDeployDoc.jl/dev/](https://nicolasl-s.github.io/SpeedMappingDeployDoc.jl/dev/)

Now I’m ready to register the new version of SpeedMapping.jl on JuliaHub. I’m just wondering whether this use of another repo to host the docs can lead to confusion with the JuliaRegistrator. I think I could probably get SpeedMappingDeployDoc.jl to deploy the docs on SpeedMapping.jl if necessary. But I’d like to avoid doing any more changes now that things seem to be working.

---

<div class="post-metadata">

### Author: ![kellertuer](https://sea2.discourse-cdn.com/julialang/user_avatar/discourse.julialang.org/kellertuer/32/220707_2.png) [@kellertuer](https://discourse.julialang.org/u/kellertuer)
#### Post date: [August 29, 2025, 7:29am UTC](https://discourse.julialang.org/t/lost-in-documentation-deployment-on-github/131668/4 "2025-08-29T07:29:18Z")

</div>

In principle that should be fine to have another repository to host the docs. However, the feedback from GiHub support sounds a bit strange. You actions do work (unless the screenshot is from a private repository, there things are different!)

Your docs on the Main repo seem to work fine and commit new docs to the `gh-pages` branch, see [GitHub - NicolasL-S/SpeedMapping.jl at gh-pages](https://github.com/NicolasL-S/SpeedMapping.jl/tree/gh-pages), so in order to not work double and render docs in multiple places try the following step

 ![Screenshot 2025-08-29 at 09.25.18](https://global.discourse-cdn.com/julialang/original/3X/7/2/72ac5fb2b918bebac084eefafa9c5f824d013579.png)

And also, if you happen to be employed at a university, you can actually get the smallest plan for free as well.

And sure, if you feel you are tired in twiddling with all that, the separate repo should be fine as well, just add the correct link in your readme to the rendered docs. But then maybe also remove the action on the original repo again to not let that one render without being needed.

_addon:_ For example [GitHub - bifurcationkit/BifurcationKit.jl: A Julia package to perform Bifurcation Analysis](https://github.com/bifurcationkit/BifurcationKit.jl) has a separate repo for its docs, see [GitHub - bifurcationkit/BifurcationKitDocs.jl: Documentation for BifurcationKit.jl](https://github.com/bifurcationkit/BifurcationKitDocs.jl). So I would say that is a bit uncommon, but can be done.
