updated schema and documentation