API proposal

A place to discuss a proposed uniform API.  Please join in the conversation.  It's barebones as of this commit, but we'll bulk it up as the conversation progresses.

@cdeil, @astrofrog - you'll probably both be interested in this.