Upgrade examples section
Review and correct existing examples for recent changes in relationship direction and other things. Add new examples as needed for further explanation. Some more developed use case based examples would be helpful, possibly in a different format, not sure.
Also, after this and #719 , re-run yaml validation on all examples.