Structure

[asinghvi17]

What kind of structure do we want for this repo? Should it follow DemoCards.jl, the homegrown Vitepress setup in GeoMakie, just straight Jupyter notebooks?

[rafaqz]

Literate code that CI builds to Jupyter notebooks?

[asinghvi17]

Sounds good. I didn't end up doing pure Literate just because nbconvert doesn't translate Markdown cells to source code (I have no clue why). There is now a Documenter.jl-formatted example in the Rasters-in-45-min folder, which should be usable with DemoCards.jl.

[felixcremer]

We should be able to use Literate to output quarto markdown files which can then be converted to whatever we need. But we can at the same time use these Literate files to build with Documenter.

[evetion]

Why not just write quarto files directly? No weird quirks in output conversions, and closes to geocompx. We have set up our whole website using quarto in that way (https://deltares.github.io/Ribasim/). Straight up Jupyter notebooks would also work well with that.