updates to the doc design(ish)