How about some documentation here for the Sidebar API?

I posted this a few days ago, I've not seen many other pieces about writing a Sidebar component. Be warned though, it's pretty long :)
Writing a Typo Sidebar Test First