adjusting docs for vm, part 1