Examples need better explanation

[JohnTheCoolingFan]

I'm reading examples to understand how exactly can I use this crate for my project. So far it wasn't very easy to understand, I had to go back and forth: exampels, script assets, API docs. And also I don't understand some comments completely, like this one. It looks like it's out of place.

This is why I think exampels need improvements to the explanation comments and more such comments.

[makspll]

I completely agree, the examples started out relatively sane but the library underwent some significant changes since its conception so some comments went astray