added markup notes for schema

see above
added schema notes