recursive classes are now documented better
[API-48] more work on schema definitions for recursive classes