I've updated the schema docs (das/das2/draft3/*.rnc ) to include more detailed comments. Also, updated the ucla examples to change 'synonym' to 'reference'. Everything should be up to date. Andrew dalke at dalkescientific.com