more editing to schema-authoring doc