Better docs for v2 and v1 refactor