updated docs for v1.2