updated design doc... a lot...

A lot to read. Obviously, we wont implement all of this. email me
comments.