yeah, the documentation on schemas is a little light - i'm adding more docs and better support for that this week and next