a few changes to schema spec docs