All of the examples are missing

[aloucks]

As stated all of the examples are gone. There's one mega example, but it's less helpful when trying to figure out a specific concept.

[madsmtm]

Yeah, we merged them in #3447, since we thought it important to give a fuller example of what a real application might look like, and a lot of the Winit developers use the examples for testing that things still work. What specific concept are you struggling with? Maybe we should re-add a basic "hello world" example too?

[kchibisov]

Examples are structured in a way that they show different aspects. As you can see, window is not a single example, but window shows the most common input/method calling related stuff, because it's not hard to grasp that and it's just all the same, just different method names, etc.

Something that requires separate examples should be in a separate example, like e.g. xembed, pump_events, child_window, on_demand, etc. Everything which is in window.rs example is related to window methods and input, there's nothing special.

Besides most old examples were dead broken and showing bad patterns. If you struggle with certain specifics around the window I'd rather improve docs.

[aloucks]

It's more that they offered an index for features and how to solve specific problems. Now the end users have to go through that whole mega example to find the thing they are looking for. Reading and understanding 1000 lines of unfamiliar code is much more involved than 50-100 lines of highly a specific example. Having an index of small examples is much easier from a user perspective.

[kchibisov]

I still don't understand, you go and read methods on the Window itself, because that's what most of them did and what got removed. Examples on how to use completely different things like pump_events, child_windows are still there.

Like if the struggle is with search within a file I'm not really sure how to help with that. In general really small examples should go into the method/event docs, since that's where they should be.

The example won't change anyway, since it's the only way to have actually useful bug reports, since you can test with that example pretty much everything relatively easy and compare.