[📖] Better docs required for static site generation (e.g. for Github Pages)

[davidde]

Suggestion

I'm simply testing the joke tutorial, and getting it deployed to Github Pages. It is not straightforward at all; at first there were countless build errors on deployment to Github Pages. Fixed them and then the README deployed instead of the app. Fixed that and then the link to the joke page was not working. Fixed that also, and now the jokes aren't refreshing on button clicks like they were in development.

Some more guidance on this would be nice. If someone can clarify why the jokes aren't refreshing or how to fix it, I could also submit a PR for an SSG Github Pages section since I've figured most of it out already anyway.

Anyway, the test repo is here: https://github.com/davidde/qwik-jokes-tutorial, with the Pages site here: https://davidde.github.io/qwik-jokes-tutorial/.

[davidde]

Anyone? It's totally ridiculous how incomplete the documentation is on this topic.

I really wanted to love Qwik, but this makes it a really hard sell ...