Update docs

@wilsonpage would you mind glancing at this?