documented new method for updating a zone