first pass at some new docs for version 1