Struggling to wrap my head around the working principles

[einarpersson]

Hi!

I have really struggled a lot with understanding the basic principles. Right now I have both converted to Svelte 5 and latest version of Svelte-Multiselect and I am getting a lot of type errors, proxy stuff I don't understand and sometimes things are just strings, sometimes things are objects etc etc.

I look at the README and see a lot of documentations of various options, but I really lack one section that just explains "this is the mental model you should have" and "this is how it works". Perhaps it is there, just a bit scattered around. I know that there are many examples but that doesnt really help either with the parts I'm struggling with. The examples aren't self-contained either (they reference other files) which is confusing furthermore.

As i was writing this, I think I've just finally solved my particular issues, but still: Please consider highlighting and moving up the essential props (eg. options), bind:selected, value etc. which are way way way more important than all the others. Try to summarize how these things fit together. Give me the big picture. Prioritise explaining the mechanics. What properties are bindable? I thought only bind:selected but in one of the examples i see bind:value... when would i use that? etc

Sorry for the confused post, but it is because I AM confused! :)

[janosh]

@einarpersson your confusion is understandable, i agree the docs/readme could do a better job of putting the essentials first and explaining key usage patterns instead of listing all props alphabetically. i just took a swing at making the readme.md and landing page of the docs more getting-started/beginner-friendly. let me know if #312 helps