Make various documentation and semantics fixes.
rename modelSpec.relations to relationships