updated doc comments for zone