Propose ADR for restructuring Quarkus workshops organization

[cescoffier]

• Suggests moving from a single repository to individual repositories per workshop
• Aims to simplify management, improve discoverability, and enable GitHub Pages for documentation
• Addresses limitations of current structure in hosting and maintaining multiple workshops

[emmanuelbernard]

Minor comment but LGTM otherwise.

[edeandrea]

I'm not sure if this is currently (or will be) something to consider, but hosting these in the quarkusio org will place some limitations on available CI resources. We want to be sure these repos are "good citizens" and aren't stealing resources away from the main quarkus repo.

[cescoffier]

@edeandrea I added a point in the Negative Consequences section.

[holly-cummins]

I think we should cross-link to the related issue, quarkusio/quarkus-workshops#548. (Which I have now done. :) )

[edeandrea]

Well, if you are going to have tests in your workshop that can run so that versions stay up to date, then this might start to become true....

[maxandersen]

if these does start take significant resources we can move them to a new org.

[cescoffier]

Sure, but let's tackle one problem at a time. Moving them to a separate organization also has downsides.

[holly-cummins]

The superheroes workshop takes more CI resources, than you'd think, because of the combinatorics. It's currently about 2.5h machine time per CI run. But I think that shouldn't affect the org decision unless we start to see an impact elsewhere in the org.

[maxandersen]

@cescoffier if it was unclear - I was just stating that if it becomes a problem it is fairly easy to move individual repos somewhere else. so we agree..

though 2.5hrs feels crazy ....what is that build doing ;)

[holly-cummins]

... because having them in a separate org would be letting the tail wag the dog, and sacrificing discoverability to accommodate a technical limitation of GitHub runners.

[holly-cummins]

though 2.5hrs feels crazy ....what is that build doing ;)

It's a static site that needs to host variations for each OS, each combination of features, etc (for example, a workshop host could share the URL https://quarkus.io/quarkus-workshops/super-heroes/variants/os-all-ai-false-azure-false-cli-false-container-false-contract-testing-true-extension-false-kubernetes-false-messaging-true-native-false-observability-false/spine.html with their participants). So it builds each variation, and the combinatorics multiply exponentially.The alternative is to generate dynamically, but that means standing up a back end and move away from GitHub pages, but that has a lot of downside.