V1.0 docs

merged + adapted from docs branch

cc @azylman going to merge this into v1.0