YouTube XML uploading

YouTube has created a fairly simple way for users to bulk upload videos. I say "fairly" because you actually need to create an XML file with the appropriate contents. As always, I seem to run into problems in the documentation and examples. I understand what it's like to write a big massive piece of documentation, then get so involved in it, you can't see the obvious errors (it's Appendix E not Appendix D).

I'll give a quick example of one thing that I was a little irritated by (because I knew it was going to break, but I had to guess which way was correct, sadly I picked wrong!):
yt:title, Required. The tag specifies the display title of a TV or movie video. This tag may have the same value as the media:title tag.
Subtag of: movie_metadata tv_metadata.
THEN..
tv_metadata, Required etc.
Subtags: id, show_title, episode, episode_title, season

Umm.. yeah.. so it's a subtag of it, but it's not a subtag of it? So it turns out, it's not! But of course I found that out the hard way (trying it).

I know it sounds like I'm getting on their case, but I assume many people read/use these documents, and has no one ever mentioned these problems?

Anyhoo! Book writing is going.. well.. no where! Sadly. Will have to get back on track next week. Tomorrow I'll post another excerpt, then another one next week!

BFN