This could really use some better explaination with examples. I am a dev for 15 years and I have no idea what it does after a minute of looking at it

Yes for sure, I need to improve the docs! I have had issues explaining it in simple terms because it is a system that is quite obvious once you get it but confusing from a first look. I have aimed to make it consistent everywhere to reduce complexity.

Better and simpler docs will be my sole focus for the following weeks + JS/TS support.

I have some diagrams and a step-by-step explanation on the README: https://github.com/windmill-labs/windmill

But the step-by-step is missing the concepts of variables and resources. If you have any feedback i'd be glad to hear it. I will opensource the website EOD too.