improve docs for lazy state redraw