Exercise for github pages?

[mmesiti]

Add an exercise for the deployment of sphinx doc to github pages, to give the learners a way to practice it.
(see coderefinery/2026-03-17-workshop#6 (comment))
Example:

Joining it all together

We just deployed a very minimal example to GitHub Pages. What would you need to change in order to...

1. ... add reference API documentation?
2. ... add Jupyter notebooks?
3. ... change the theme? Have a look at a list of themes

[frankier]

So is this a "think about it" exercise? Or could we have an actual exercise break and ask them to fork the repo and add one of these things? Maybe we could even set up the main repo so that pull requests get built and there's a preview in the pull request? That way the exercise break could be relatively short if that helps?

[mmesiti]

So is this a "think about it" exercise? Or could we have an actual exercise break and ask them to fork the repo and add one of these things? Maybe we could even set up the main repo so that pull requests get built and there's a preview in the pull request? That way the exercise break could be relatively short if that helps?

I think that every exercise can be written with different levels of "care".
The "think about it/discuss" level is the easiest, we might start with it. Providing solutions to questions should also be relatively quick.

Letting people do pull requests on a base repository and show them in real time might be a cool idea (we need two repos, though - the "recorded" and the not recorded one), I guess that this is the most direct way that people have to get feedback on their learning without being in an in-person room... But it might require more work.