new docs on writing automated tests