search

geocompx / geocompjl

Geocomputation with Julia: an open source book
https://jl.geocompx.org/
Other
11 stars 2 forks source link

Preview builds #16

Closed asinghvi17 closed 2 months ago

asinghvi17 commented 2 months ago

In Julia documentation we have the ability to push "preview" builds of PRs, that don't replace the main docs, but are in a subfolder in the gh-pages branch like /previews/PR$pr_num. See e.g. https://juliageo.org/GeometryOps.jl/previews/PR206/ vs https://juliageo.org/GeometryOps.jl/stable for an example.

It would be nice to have that here too! Right now any authorized CI run will overwrite the main content of the page.

One option I was thinking of was to use quarto render instead of quarto build, and use Documenter.jl's deploydocs system to create directories in gh-pages where builds off of different places deploy to different paths:

This is a notable departure from the regular geocompx deployment method, is this something we should add?

asinghvi17 commented 2 months ago

To keep deployment and URLs the same, maybe we slightly modify this:

and remove the concepts of stable and dev entirely.