update draft docs with schema