Documentation changes for the frontpage

These are early, and I want discussion on this.  @astrofrog, @jdnc - chime in as you see fit.  As part of this PR, we should update the API to reflect the changes made during the rebase process.