doco updates and make operations virtual