Aha! Thanks. YAML isn't really my thing (though I can JSON with the best of them). I'll try that out today.
You might consider adding another child entity to the relationships documentation ("articles" belongs_to "authors", perhaps) to make the example a little more real-world. Few real projects have only one relationship.
collectionand possibly specify the