added comment and describe functions to the schema documentation.