Many thanks for this detailed feedback and example.

I totally agree a tutorial like this is needed, and I am going to add such documentation soon...