Better docs for v2 and v1 refactor

Since we decided to keep these