add docs about v1
add link to docs
fix typos
warn about v0 in docs