I'd like to have the api you've decided on documented in one place. Maybe the top of the viewlet manager or something. Kind of a "big picture" doc to go through for new users and reminders on how the parts talk.