more docs on locator usage