On the net are a few examples to write an online cv in html5 with metadata. I'm also code it like that. In my opinion it is too complicated to describe it naturally. A lot of people have a strict and straight way to describe but also many people can't do that. There are forced to mix it a lot so that software can't understand anything. I have tested it once with a testing tool as demo for a recruiting software (cv parser). In my case are the output beeing ceo and student at the same time because I founded extracurricular projects as teenager and opened a business later. It is practically impossible now to write a resume with (many) overlapping changes that can not be separated clearly. How am I supposed to define inter-company vocational training? Sure I can only define the employer. But then I have not the possibility to list the accomplishments I gained in the other companies without interrupting the parser software. So you have to use seldom used vocabularies like EmployeeRole.

Therefor I wish for an extra vocabulary for resumes like the outdated h-resume microformat including properties of JobPosting, OrganizationRole and EmployeeRole. It would be nice if you could describe positions for a job-hopper/reserve employee in detail. Like 10 years as dishwasher in a restaurant leaving and coming back as cook and waiter part-time and taking over the shop after another five years.

If you think the actual vocab is enough please set examples in the documentation.