comments/doc on schema. we can move this wherever/to file if preferred