Hi Alex, We need to define "properly maintained" ;). Currently, examples repo is integrated into the CI pipeline for runtimes and apps. This means that if some change in runtimes or apps repos breaks an example, the PR will be red and won't be merged. That's another layer of "security" from a quality perspective and forces us to keep examples working. They are also a good way for community users to test the latest changes on main before they are released. If they checkout main branch, since, by default, examples on main point to 999-SNAPSHOT version, they will be using latest snapshot, which is a good alternative for users that do not want to wait for a release to perform experiments. Therefore, I think your latest proposal is great. We keep everything as it is and release examples separately. Thanks a lot.
On Wed, Jan 8, 2025 at 1:17 AM Alex Porcelli <a...@porcelli.me> wrote: > Thanks for sharing your perspective, Francisco. You raise a valid > point about user experience; however having a dedicated examples repo > doesn’t necessarily help if it isn’t properly maintained—what’s the > purpose of an examples repository if it doesn’t reference the current > release? > > One idea to address this, which we could borrow from our IBM > colleagues, is to create a separate release artifact for the examples. > We could then publish the artifact content into a dedicated repository > manually whenever we cut a release. This way: > > - Maintenance & Integration: We still integrate the examples in our > main build process (so they remain aligned with each release). > - User-Friendly Browsing: At the same time, the standalone examples > repository remains easy to browse, avoiding the complexity of a large, > all-in-one codebase. > > This approach keeps the examples maintained in sync with releases > while offering a simpler path for users to find and explore them > without wading through the entire repository structure—which can be > overwhelming. > > I volunteer myself to adjust the CI to produce this artifact in the > release pipeline. > > On Tue, Jan 7, 2025 at 6:51 AM Francisco Javier Tirado Sarti > <ftira...@redhat.com> wrote: > > > > Hi, > > I can see why it is easier, from a technical point of view, since some > > examples rely on tooling, to move all examples to tooling repo. > > However, I hardly see why this makes users' experience better. > > Let me elaborate, With examples repo, we currently have a place where > users > > can browse all examples starting from the repo root. > > With tooling repo, I guess they will start browsing under examples > > directory? > > If we are going for technical simplicity, I guess it is probably time to > be > > coherent and move all KIE content under the same repo (I'm not for it, > but > > I have the feeling that there is a majority in favour of that, so > probably > > time to vote?). > > Which I feel is really awkward is to have different strategies under the > > same label (some content in some separate repos and gradually moving > > everything to a repo named "tools" which is not really just "tools" > > anymore) > > > > > > On Mon, Jan 6, 2025 at 5:26 PM Jason Porter <jpor...@ibm.com.invalid> > wrote: > > > > > I know it makes for a larger repo, but I’m all for fewer repositories, > and > > > an easier setup for not only contributors, but all users. > > > > > > -- > > > Jason Porter > > > Software Engineer > > > He/Him/His > > > > > > IBM > > > > > > > > > From: Alex Porcelli <porce...@apache.org> > > > Date: Monday, January 6, 2025 at 03:01 > > > To: dev@kie.apache.org <dev@kie.apache.org> > > > Subject: [EXTERNAL] [DISCUSS] Missing kogito-examples update for the > > > 10.0.0 release! > > > Happy new 2025, everyone! > > > > > > As we discussed when we started the 10.0.0 release process, the > > > kogito-examples repository was neither included in the release nor > fully > > > integrated into CI. Although some PR checks consider kogito-examples, > this > > > gap ultimately led to absent examples for the 10.0.0 release. > > > > > > Currently: > > > > > > - The stable branch remains on versions 1.44 and 8.44 > > > - The main branch is on 999-SNAPSHOT > > > > > > Given that many of the kogito-examples rely on container images and > Dev UI, > > > we'd need to incorporate the repository into our CI system to improve > the > > > current situation, which might take some time and will likely impact > the > > > upcoming releases. > > > > > > Alternatively, we could move the examples to kie-tools (a repo that > already > > > hosts all images and DevUI) so no CI changes would be required. > > > > > > I would love to hear your thoughts, alternative ideas, or concerns so > we > > > can have an actionable plan to do better in the next release. > > > > > > Regards, > > > Alex > > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@kie.apache.org > For additional commands, e-mail: dev-h...@kie.apache.org > >
