updated doc for record save logic