updated common-3 schema documentation.. (MID-1837)