That's a good start. I tried to read it twice and I grokked some of it. I'd like to see something written to the same level of detail we've just been working on, ie the actual user documentation we would ship. This seems to really force a sane design.